Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/speedyapply/JobSpy/llms.txt

Use this file to discover all available pages before exploring further.

Google Jobs aggregates job postings from across the web into a unified search experience. JobSpy’s Google scraper works globally and does not require any country or location parameter beyond what you include in the google_search_term.
Google Jobs requires very specific query syntax. If you use an incorrect query format, you will get zero results. Read the usage instructions carefully before searching.

​
Basic usage

Set site_name to "google" and use the google_search_term parameter — not search_term: 
from jobspy import scrape_jobs

jobs = scrape_jobs(
    site_name="google",
    google_search_term="software engineer jobs near San Francisco, CA since yesterday",
    results_wanted=20,
)
print(f"Found {len(jobs)} jobs")
print(jobs.head())

​
Supported parameters

ParameterTypeDescription
google_search_termstrThe full search query for Google Jobs (see below)
results_wantedintNumber of results to return
offsetintStart results from this position
Google Jobs does not use the search_term, location, hours_old, job_type, or country_indeed parameters. All filtering must be encoded in google_search_term.

​
Getting the right query syntax

Google Jobs search queries must match the exact format Google expects. The easiest and most reliable way to get a working query is:
  1. Open Google in your browser and search for jobs (e.g., software engineer jobs San Francisco).
  2. Click on the Jobs tab in the search results to open Google Jobs.
  3. Apply any filters you want (location, date posted, job type, etc.).
  4. Copy the exact text from the Google Jobs search box.
  5. Use that string as your google_search_term.
The query text in the Google Jobs search box after applying filters is exactly what you need. For example, after filtering by location and recency, the box might show:software engineer jobs near San Francisco, CA since yesterdayCopy that string verbatim.

​
Query syntax examples

# Jobs posted in the last 3 days near a city
google_search_term="data analyst jobs near Austin, TX in the last 3 days"

# Remote jobs in a specific field
google_search_term="remote machine learning engineer jobs"

# Jobs from the last week in a specific country
google_search_term="product manager jobs near London, United Kingdom in the last week"

# Full-time internship filter
google_search_term="software engineering internship Full time jobs near Seattle, WA since yesterday"

​
Time filter keywords

Google Jobs recognizes these natural-language time phrases:
PhraseEquivalent hours
since yesterdayLast 24 hours
in the last 3 daysLast 72 hours
in the last weekLast 7 days
in the last monthLast 30 days
JobSpy maps hours_old to these phrases when building a query automatically, but when using google_search_term directly you must include the phrase yourself.

​
Geographic coverage

Google Jobs searches globally. Specify the location directly in google_search_term using natural language such as near [City, Country].

​
Notes

  • If your query returns zero results, the query syntax is most likely incorrect. Try copying the query directly from a browser Google Jobs search.
  • Google Jobs results are capped at approximately 1,000 per query.
  • The google_search_term parameter overrides any automatic query constructed from search_term, location, or hours_old when both are provided.

Build docs developers (and LLMs) love

Get started for freeTalk to us