Skip to main content
GET
Search Google Jobs

Authorizations

x-api-key
string
header
required

Query Parameters

q
string
required

Job title / keywords / combined query.

location
string | null

City / state / region — concatenated with q before sending to Google.

gl
string
default:us

Country code (ISO 3166 alpha-2).

country
string | null

Alias for gl; when present overrides it.

hl
string
default:en

Language code.

language
string | null

Alias for hl; when present overrides it.

domain
string
default:google.com

Google domain for locale-specific results (google.com, google.co.uk, google.co.in, …).

job_type
enum<string> | null

Employment type — translated into a chips filter.

Available options:
FULLTIME,
PARTTIME,
CONTRACTOR,
INTERN
date_posted
enum<string> | null

Posted-date window — translated into a chips filter.

Available options:
today,
3days,
week,
month
ltype
enum<string> | null

Work arrangement — maps onto Google's remote/hybrid/onsite chips.

Available options:
remote,
hybrid,
onsite,
work_from_home
chips
string | null

Raw Google chip-filter string (comma-separated). Merged with any structured filters (job_type, date_posted, ltype).

uds
string | null

Opaque Google filter token harvested from a prior Jobs search URL.

uule
string | null

Google's UULE-encoded location (e.g. w+CAIQIFJlbGF5IFN0YXRlcw==).

lrad
string | null

Search radius around the location (Google accepts a distance in miles).

next_page_token
string | null

Opaque token from the previous response's pagination.next.

mode
enum<string>
default:rpc

Data source. rpc (default, ~300 ms) replays Google's own r06xKb batchexecute RPC on the Google Careers portal — clean JSON, 20 roles per page, scope = Google's internal openings. serp uses the public Jobs search vertical (udm=8, SERP-embedded, 3rd-party aggregator) and costs more latency because Google gates it behind JS.

Available options:
rpc,
serp

Response

Successful Response

Response for GET /api/v1/jobs/search.

pagination
Pagination · object
required

Pagination metadata.

jobs
JobResult · object[]
jobs_results
JobResult · object[]
filters
JobFilter · object[]