---
title: "Search job postings on Google"
method: POST
path: "/google/search-job-postings"
tags: ["Google"]
---

# Search job postings on Google

`POST /google/search-job-postings`

## Request

- Base URL: `https://api.exfunc.dev`
- URL: `https://api.exfunc.dev/google/search-job-postings`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/carvedai/apis/exfunc-apis/docs/google/search-job-postings/post.ts> (a function with typed inputs; its response is checked against the schema)

Search job postings on Google for a given query

## Request body

- object
  - `query` string, required: The search query for job postings
  - `location` string: Location to filter job postings
  - `job_source` string: Source (publisher) to filter job postings. If not provided, postings from all sources will be retrieved
  - `country_code` string: The country code to filter job postings
  - `date_posted` 'Any time' | 'Past 24 hours' | 'Past 3 days' | 'Past Week' | 'Past Month': Filter for job postings based on when they were posted
  - `job_types` string[]: Job types to filter (e.g., Full-time, Part-time)
  - `page` integer: Page number for pagination (default is 1)
  - `num_pages` integer: Number of pages to return, starting from page (default is 1)

## Response `200`

SearchJobPostings API successful response

- object
  - `job_postings` GoogleJobPosting[]
    - `id` string: The ID of the job posting
    - `url` string, uri: The URL link to the Google job posting
    - `title` string: The title of the job posting
    - `location` string: The location of the job posting
    - `description` string: Detailed description of the job posting
    - `job_type` string, nullable: Type of job (e.g., Full-time, Part-time)
    - `date_posted` string, date-time, nullable: Date when the job was posted
    - `publisher_name` string: Name of the publisher of the job posting
    - `publisher_url` string, uri: URL of the publisher job posting
    - `company_name` string: Name of the company offering the job
    - `company_website_url` string, uri, nullable: URL to the company's website

## Other responses

- `400`: User error response
- `500`: Server error response

## Changes

- **2024-12-04** `5b28df689ad7`: 3 info
  - added the new optional request property `job_source`
  - the `num_pages` request property default value `1` was added
  - the `page` request property default value `1` was added
- **2024-12-03** `6dbf4c337254`: 2 warning, 1 info
  - the `page` request property's max was set to `100.00`
  - removed the request property `per_page`
  - added the new optional request property `num_pages`
- **2024-12-02** `f5fc570f7d09`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/carvedai/apis/exfunc-apis/changes/google/search-job-postings/post.md)

---

[API](https://skmtc.dev/carvedai/apis/exfunc-apis.md) - [All operations](https://skmtc.dev/carvedai/apis/exfunc-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/carvedai/apis/exfunc-apis/revisions/22587fdf9a5e?raw)