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

# ZipRecruiter

> Scrape job postings from ZipRecruiter for the US and Canada using JobSpy.

ZipRecruiter is a job marketplace focused on the United States and Canada. JobSpy's ZipRecruiter scraper uses the ZipRecruiter jobs API and fetches full job descriptions and direct application URLs automatically.

## Basic usage

Set `site_name` to `"zip_recruiter"`:

```python theme={null}
from jobspy import scrape_jobs

jobs = scrape_jobs(
    site_name="zip_recruiter",
    search_term="software engineer",
    location="Chicago, IL",
    results_wanted=25,
    hours_old=72,
)
print(f"Found {len(jobs)} jobs")
print(jobs.head())
```

## Supported parameters

| Parameter        | Type   | Description                                                  |
| ---------------- | ------ | ------------------------------------------------------------ |
| `search_term`    | `str`  | Keywords to search for                                       |
| `location`       | `str`  | City and state (US or Canada)                                |
| `distance`       | `int`  | Search radius in miles (default: 50)                         |
| `job_type`       | `str`  | `fulltime`, `parttime`, `internship`, `contract`             |
| `is_remote`      | `bool` | Filter for remote jobs                                       |
| `hours_old`      | `int`  | Only jobs posted within this many hours (rounded up to days) |
| `results_wanted` | `int`  | Number of results to return                                  |
| `offset`         | `int`  | Start results from this position                             |

## Geographic coverage

ZipRecruiter only searches jobs in the **United States and Canada**. Use the `location` parameter to specify a city and state or province.

<Note>
  Searching for locations outside the US or Canada may return no results or results with unexpected locations.
</Note>

## `hours_old` rounding

ZipRecruiter's API filters by whole days. When you pass `hours_old`, JobSpy rounds up to the next full day:

* `hours_old=25` → filters for jobs posted in the last **2 days**
* `hours_old=48` → filters for jobs posted in the last **2 days**
* `hours_old=49` → filters for jobs posted in the last **3 days**

## Description fetching

Unlike LinkedIn, ZipRecruiter always fetches the full job description and direct application URL — no additional parameter is needed. Each job listing makes an extra request to retrieve the complete description from the job detail page.

## Notes

* ZipRecruiter is not available in the EU. Requests from EU IP addresses may return errors.
* A `429` response indicates you have been rate-limited. Wait several minutes or use the `proxies` parameter before retrying.
* All job board searches are capped at approximately 1,000 results per query.