ZipRecruiter Job Search returns up to 20 jobs per page for the US, Canada (country=ca) and the UK (country=uk). For Canada the company has a name and logo but no slug or address, because company profiles cover US-hosted employers. Each job has the title, company, location parts, pay (minimum, maximum, interval, yearly value, estimate flag), employment types, location types, benefits, posting time, the job page address, the apply address and Breakroom highlights. The first job of a page also carries its full description; the other jobs carry the text ZipRecruiter shows in the list (description_is_full tells which). Use job_id with the Job Details endpoint for the full text of every job.
Every filter is checked against the page before the answer is sent. A filter the site ignores makes the request fail instead of returning wrong jobs. Page N is never filled with page 1. A page after the last one returns 422. ZipRecruiter shows no jobs beyond page 3, so one search reaches 60 jobs. Use filters to reach other jobs. The UK site is small and supports only query, location and page. A request costs 1 credit. A failed request is not charged.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
9 optional filters available.
string
Required
Job title or keywords, for example nurse.
coffee shops
string
Optional
City and state, for example Austin, TX. Not allowed with remote.
Austin, Texas
string
Optional
us (default), ca or uk. The UK index is small and supports only query, location and page.
US
integer
Optional
Miles around the location, 5 to 100. Not for the UK.
10
integer
Optional
Only jobs posted in the last 1 to 30 days. Not for the UK.
10
string
Optional
full_time, part_time, contract or temporary. Not for the UK.
example
integer
Optional
Minimum yearly salary. Not for the UK.
10
integer
Optional
Maximum yearly salary. Not for the UK.
10
boolean
Optional
true searches remote jobs only. Do not send a location with it.
true
integer
Optional
Result page, 1 to 3. Each page has up to 20 jobs. Default 1.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"jobs": [
{
"id": "xxq9mE0a9_wqH-9RzGSBbQ",
"pay": {
"max": 153800,
"min": 128600,
"text": "$128K - $153K/yr",
"currency": "USD",
"interval": "year",
"max_annual": 153800,
"min_annual": 128600,
"is_estimated": false
},
"url": "https://www.ziprecruiter.com/c/One-Medical/Job/Family-Nurse-Practitioner-or-Physician-Assistant-(South-Austin-clinic)-4-days-in-clinic,-1-day-remot/-in-Austin,T...",
"title": "Family Nurse Practitioner or Physician Assistant (South Austin clinic) 4 days in clinic, 1 day remot",
"is_new": true,
"job_id": "17e6c127e6cbf179",
"company": {
"url": "https://www.ziprecruiter.com/co/One-Medical/Jobs",
"name": "One Medical",
"slug": "One-Medical",
"logo_url": "https://www.ziprecruiter.com/svc/fotomat/public-nosensitive-ziprecruiter-logos/company/a0e2553b.png"
},
"benefits": [
"Medical",
"Dental",
"Vision",
"Life",
"Retirement",
"PTO"
],
"location": {
"city": "Austin",
"state": "Texas",
"county": "Travis",
"country": "United States",
"display": "Austin, TX",
"state_code": "TX",
"postal_code": "78701",
"country_code": "US"
},
"apply_url": "https://www.ziprecruiter.com/job-redirect?match_token=TEST",
"posted_at": "2026-10-28T01:42:47Z",
"highlights": [
{
"id": "people_enjoy_their_job",
"label": "People enjoy working here"
},
{
"id": "well_rated_employer",
"label": "Good employer"
},
{
"id": "recommended_by_parents",
"label": "Recommended by parents"
},
{
"id": "managers_treat_people_with_respect",
"label": "Respectful managers"
},
{
"id": "people_get_proper_training",
"label": "Good training"
},
{
"id": "proper_breaks",
"label": "Uninterrupted breaks"
}
],
"description": "About Us\n\nOne Medical is a primary care solution challenging the industry status quo by making quality care more affordable, accessible and enjoyable. But this ...",
"posted_label": "3 days ago",
"location_types": [],
"description_html": "<div>\n <div>\n <p><strong>About Us</strong></p>\n </div>\n <div>\n <p>One Medical is a primary care solution challenging the industry status quo by making quality...",
"employment_types": [
"Full-time"
],
"description_is_full": true
},
{
"id": "GCn8FC_qmLOtdfA4-1bGJA",
"pay": {
"max": 47.5,
"min": 33.75,
"text": null,
"currency": "USD",
"interval": "hour",
"max_annual": 95000,
"min_annual": 67500,
"is_estimated": false
},
"url": "https://www.ziprecruiter.com/c/Central-Health/Job/Clinical-RN-Navigator-Multi-Specialty-Clinic/-in-Austin,TX?jid=775a1270a8b0ebde",
"title": "Clinical RN Navigator - Multi-Specialty Clinic",
"is_new": true,
"job_id": "775a1270a8b0ebde",
"company": {
"url": "https://www.ziprecruiter.com/co/Central-Health/Jobs",
"name": "Central Health",
"slug": "Central-Health",
"logo_url": "https://www.ziprecruiter.com/svc/fotomat/public-nosensitive-ziprecruiter-logos/company/aeb48283.png"
},
"benefits": [],
"location": {
"city": "Austin",
"state": "Texas",
"county": "Travis",
"country": "United States",
"display": "Austin, TX",
"state_code": "TX",
"postal_code": "78716",
"country_code": "US"
},
"apply_url": "https://www.ziprecruiter.com/job-redirect?match_token=TEST",
"posted_at": "2026-10-31T05:19:04Z",
"highlights": [],
"description": "Nurse Navigator The Nurse Navigator is responsible for supporting the navigation of patients through complex healthcare environments for the optimization of car...",
"posted_label": "18 hours ago",
"location_types": [
"On-site"
],
"description_html": null,
"employment_types": [],
"description_is_full": false
}
],
"country": "us",
"pagination": {
"page": 1,
"total": 190,
"per_page": 20,
"has_next_page": true
}
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Invalid Page
This result page does not exist. Use a lower page. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "search"
},
"error": {
"code": "INVALID_PAGE",
"message": "This result page does not exist. Use a lower page."
},
"success": false
}Invalid Request
A parameter is missing or has the wrong format. This response is not billable.
{
"errors": {
"query": [
"The query field is required."
]
},
"message": "The request validation failed"
}Upstream Unavailable
ZipRecruiter could not be reached, or the page did not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "ZipRecruiter could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.