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.

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

ParameterTypeDescription
search_termstrKeywords to search for
locationstrCity and state (US or Canada)
distanceintSearch radius in miles (default: 50)
job_typestrfulltime, parttime, internship, contract
is_remoteboolFilter for remote jobs
hours_oldintOnly jobs posted within this many hours (rounded up to days)
results_wantedintNumber of results to return
offsetintStart 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.

Build docs developers (and LLMs) love

Get started for freeTalk to us