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