---
title: "Scrape Google Jobs listings"
method: POST
path: "/jobs/google-jobs"
tags: ["Plugins"]
---

# Scrape Google Jobs listings

`POST /jobs/google-jobs`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/jobs/google-jobs`
- Auth: API key in header `x-scrapeunblocker-key`

Runs the Google Jobs vertical (`udm=8`) for `q` and returns the job cards as JSON: `title`, `company`, `location`, `via` (source), `salary`, `employmentType`, `remote`, `postedAge`, `qualifications`, `benefits`, `logo`, a stable `jobId` and a `shareUrl`. Append a `location` to narrow the search, and set `proxy_country`/`gl`/`hl` to target a market. One render returns ~10 jobs (v1).

## Query parameters

- `q` string, required: Job search term, e.g. 'software engineer' or 'nurse'.
- `location` string, nullable: Optional location, appended to the query, e.g. 'Austin, TX'.
- `hl` string: Google UI language, e.g. 'en', 'de'.
- `gl` string: Google country of search, ISO-2, e.g. 'us'.
- `max_results` integer: How many jobs to return. One render yields ~10 (v1).
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Jobs are location-sensitive; pick the market you want.

## Response `200`

JSON with a `jobs` array plus the query and count.

- unknown

## Other responses

- `403`: Blocked by Google CAPTCHA after retries - try another proxy_country.
- `422`: Validation Error
- `502`: No jobs collected (upstream block or no matches), or the call did not finish in time.

---

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