> ## 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

> Scrape job postings from Google Jobs globally using JobSpy.

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`.

<Warning>
  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.
</Warning>

## Basic usage

Set `site_name` to `"google"` and use the `google_search_term` parameter — **not** `search_term`:

```python theme={null}
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

| Parameter            | Type  | Description                                       |
| -------------------- | ----- | ------------------------------------------------- |
| `google_search_term` | `str` | The full search query for Google Jobs (see below) |
| `results_wanted`     | `int` | Number of results to return                       |
| `offset`             | `int` | Start results from this position                  |

<Note>
  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`.
</Note>

## 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`.

<Tip>
  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 yesterday`

  Copy that string verbatim.
</Tip>

## Query syntax examples

```python theme={null}
# 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:

| Phrase               | Equivalent hours |
| -------------------- | ---------------- |
| `since yesterday`    | Last 24 hours    |
| `in the last 3 days` | Last 72 hours    |
| `in the last week`   | Last 7 days      |
| `in the last month`  | Last 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.