---
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`

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

---

[API](https://skmtc.net/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.net/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/revisions/22587fdf9a5e/schema)