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":

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.

Searching for locations outside the US or Canada may return no results or results with unexpected locations.

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.