---
title: "Search Google Jobs"
method: POST
path: "/google/jobs"
tags: ["Google"]
---

# Search Google Jobs

`POST /google/jobs`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/google/jobs`
- Auth: API key in header `x-api-key`

Searches Google Jobs for the `query` in the request body, optionally narrowed by `location` and paged with `page`. Each result has the job title, company, location, employment type, posting time, snippet, source and URL. The response echoes the query, location and page.

## Headers

- `x-api-key` string, required

## Request body

- GoogleJobsOption
  - `location` string
  - `page` integer
  - `query` string, required

## Response `200`

OK

- GoogleJobsResponse
  - `location` string: Location filter that was applied. Omitted when none was given.
  - `page` integer: Page number returned, starting at 1.
  - `query` string: Search query that was run.
  - `results` GoogleJobItem[]: Job postings on this page.
    - `company` string: Name of the hiring company.
    - `employment` string: Employment type shown on the job card, for example full-time.
    - `location` string: Job location as shown on the job card.
    - `posted_at` string: How long ago the job was posted, as Google shows it, for example `3 days ago`.
    - `snippet` string: Short description text from the job card.
    - `source` string: Site or board Google lists the job from.
    - `title` string: Job title as shown on the job card.
    - `url` string: URL of the job posting.

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)