scraper
Back to API docs

Overview

  • Overview

SERP

  • POSTSERP

Core

  • POSTGeocode
  • POSTTranslate
  • POSTSearch
  • POSTVision
  • POSTPlaces Search
  • POSTPlace Details
  • POSTPlaces Nearby
  • POSTAutocomplete

Maps

  • POSTSearch
  • POSTPlace Details
  • POSTReviews

Hotels

  • POSTSearch
  • POSTDetail
  • POSTReviews
  • POSTPhotos

Play

  • POSTReviews

Flights

  • POSTOne-way Search
  • POSTCalendar
  • POSTExplore

Jobs

  • POSTJobs Search

Finance

  • POSTQuote
  • POSTFundamentals
  • POSTChart
  • POSTNews
  • POSTSearch
  • POSTEstimates
  • POSTEarnings

Google Jobs Search

2 credits

Search Google Jobs for a keyword and a location. Get job titles, employers, locations, descriptions, pay, and application links.

POST/api/v1/tools/google/jobs/search

Parameters

keywordstring

Job title, skill, or search phrase, from 1 to 200 characters. Required when searchUrl is not set.

searchUrlstring

An HTTPS Google Jobs search link on a Google search domain, with a q value. The q value replaces keyword. Its country (gl) and language (hl) values are the defaults for countryCode and languageCode. Send keyword or searchUrl.

googleDomainstring

Google search domain to use, such as "google.co.uk" or "google.co.in". Defaults to "google.com".

locationstring

City or region, from 1 to 200 characters, such as "Fresno CA".

countryCodestring

Two-letter country code, such as "US". Defaults to the gl value of searchUrl, or "IN".

languageCodestring

Language code, from 2 to 10 characters, such as "en". Defaults to the hl value of searchUrl, or "en".

maxResultsnumber

Most jobs to return, as a whole number from 1. Defaults to 10. There is no fixed upper limit, but a large value takes longer and the call must finish within 120 seconds.

includeJobDetailsboolean

Load more detail for each returned job, such as the employer website and ratings, when Google shows them. Defaults to false. This makes the call slower, so start with a small maxResults.

expandSearchboolean

Also search the Google date and job type variants of the search, and remove repeated jobs. Your own datePosted and jobTypes filters stay. Defaults to false.

resolveCompanyWebsiteboolean

Look up the website of the employer when a job shows none. Jobs of the same employer share one lookup. A job stays in the result when no website is found. A match does not prove that the employer owns the site. Defaults to false.

enrichContactsboolean

Read the website of the employer of each job that has one, and add emails, phoneNumbers, socialProfiles, and contactsStatus. Jobs of the same website share one visit. Use includeJobDetails or resolveCompanyWebsite to find the website of more jobs. Contacts add no credits. Defaults to false.

filtersobject

Result filters, all optional: datePosted ("any", "past-day", "3-days", "week", or "month"), jobTypes (up to 4 of "full-time", "part-time", "contract", "internship"), remoteOnly, noDegreeMentionedOnly, and radiusKm (a number above 0; Google can still return jobs outside the radius). Also salaryOnly, postedWithinHours (a number above 0; a job with no known posting date is left out, and a date such as "3 days ago" is an estimate), and lists of name fragments, matched without regard to letter case: companyFilter (keep jobs whose employer contains one of them), excludeCompanies (drop jobs whose employer contains one of them), and viaFilter (keep jobs whose listing source contains one of them). A field that is not in this list returns 400.

Response Schema

dataobject

Google Jobs search result

jobsobject[]

Jobs with distinct IDs, in the order Google lists them

returnedCountnumber

Number of jobs in jobs

requestedCountnumber

The maxResults value used

truncatedboolean

true when the result was cut at maxResults, or the search ended before every page was read. false does not give the total number of matching jobs

pagesProcessednumber

Number of result pages read, when reported

metaobject

Request metadata

toolstring

Tool name (google-jobs-search)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/jobs/search \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"keyword": "certified nursing assistant",
"location": "Fresno CA",
"countryCode": "US",
"maxResults": 20
}'

Response Example

{
"data": {
"jobs": [
{
"id": "mBdGpYoWEsTQB2vIAAAAAA==",
"title": "Certified Nursing Assistant (CNA)",
"company": "Sunnyside Rehab of Fresno",
"location": "Fresno, CA",
"links": [
{
"label": "Apply directly on Indeed",
"url": "https://www.indeed.com/viewjob?jk=f40a87dc11b57424&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic"
}
],
"employment": {
"types": [
"Full-time"
]
},
"salary": {
"text": "$19 an hour",
"disclosed": true,
"min": 19,
"max": 19,
"currency": "USD",
"period": "hour"
},
"education": {
"label": "No Degree Mentioned"
},
"source": {
"name": "Indeed",
"url": "https://www.indeed.com/viewjob?jk=f40a87dc11b57424&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"domain": "www.indeed.com"
},
"applyOptions": [
{
"provider": "Indeed",
"url": "https://www.indeed.com/viewjob?jk=f40a87dc11b57424&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
"direct": true
}
],
"applyLinkCount": 8
}
],
"returnedCount": 1,
"requestedCount": 20,
"truncated": false
},
"meta": {
"tool": "google-jobs-search",
"creditsUsed": 2,
"requestId": "req_abc123"
}
}