Jobs & Hiring

ZipRecruiter API

The ZipRecruiter API returns live US job listings as clean JSON.

3 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns jobs with id, title, company, location, salary (min, max, currency, period), posted date, snippet and URL, and you can pull a job_detail and jobs_by_company. It is built for recruiting tools, labor-market analysts and job boards that need ZipRecruiter data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/ziprecruiter/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "software engineer",
    "location": "London",
    "country": "gb",
    "max_results": 20
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "ziprecruiter",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1153.8,
    "record_count": 20,
    "bytes": 86381,
    "cache_hit": false,
    "completeness_pct": 100,
    "country": "gb",
    "total_estimate": null,
    "salary_present": 6,
    "sponsored": 20
  },
  "data": {
    "query": "software engineer",
    "location": "London",
    "country": "gb",
    "total_estimate": null,
    "count": 20,
    "jobs": [
      {
        "job_id": "[redacted-phone]",
        "title": "Software Engineer",
        "company": "SF Partners",
        "location": "Worcester, ENG, GB",
        "salary": null,
        "posted_date": "02 Jul",
        "snippet": "Job Description Software Engineer with key skills across the PHP stack and solid AWS and AI tooling exposure ideally gained in a product/ platform...",
        "url": "https://www.ziprecruiter.co.uk/jobs/[redacted-phone]",
        "apply_url": "https://www.alertsclk.com/ekn/AAINkpS-X1yznxEFbLg1g8PQGPlTXkuVy1bAW9vZGoOWlfWthEGjRUxcFDsSVWuaH6JbPPIJXKjZdvg8TTVKHTKliNa8cFbps_9KbW7sFY9llUgbO69n9k0l-UdxuM45_mqLPYmzu6X8ioL2BTUCLIa34EcXhD3uUNFomkhBAY4A6KnavqIVr1a_IuBcyAHuS4dGpiU9JJdJ_czsNbhdUF45r-sM9GOGOpC1CmqkY1RwqgbA7acJ27SKi3ptnEGk9AKx0x3o7ntqS-Qlj7lcHX8P3GDfBIlw0Y6t-QBr8r1h-srmqQPoVVhBvnvWjzIaNlLCsMZV-2TMqioEmzQyKUYtU5zZqcLcLHIUiJO3Woskn8st35t2BZQKp4yJyMep3gT3xEj23BDNO5JKZcH9jekt1o2PYPgK7RDT1lALpQyvGUlMKnhJeXeho_ZrO4LbNvs2ELR7eaWSGVi7m0OykRSzyEGF4j0qVBjsNjb6kbzOWLZKIN2evt1z2Kh6HZxjUKOCpYiSQhUMKMWXv5TW5oC1irLzEMmpiK45QQ4oOhRKy5RYwWG91Mn_1N",
        "sponsored": true,
        "source": "ziprecruiter.co.uk"
      },
      {
        "job_id": "[redacted-phone]",
        "title": "Software Engineer",
        "company": "Avanti",
        "location": "Marlow, ENG, GB",
        "salary": {
          "min": 40000,
          "max": 50000,
          "currency": "GBP",
          "period": "year",
          "raw": "£40,000 - £50,000",
          "source": "text"
        },
        "posted_date": "02 Jul",
        "snippet": "Job Description Full Stack Software Engineer Hybrid Working | £40,000 - £50,000 + Benefits A growing software company is looking for a Full Stack...",
        "url": "https://www.ziprecruiter.co.uk/jobs/[redacted-phone]",
        "apply_url": "https://www.alertsclk.com/ekn/AAKNQc8eWpOqjx6R3SUxr5CYR4GoK_YjGXHJZar4xG0Nxn1JXbViTH04P3y9Iq5ApOBu9e9BF0PJpGeZdOxRAoBImVxS-UPt2iFCRKgYelyw7eIeZh_QldsJubY2PaLwKyD90TsGU6i0SH_z6lHZ2w3edYsbXDbOM_MgWgW1F-5G6fCxJETf-eEvtuTEQqu-FilCRHFyJhSU_EsGGKagXbnFRqXR9IJgLFYeXteu3JkdKOGOi0bSnRvSHv7hS5VFPewUZqAw9o9GT5gibYjFQrWo6HEgEx-Q4xrqe-X9htMbFmc0IwBd7zTBBpSiVQ-88c7kpYTh4uxBVRMQwDqD8kfj3xxHjumPCc3mNWM8dIBL_vDb4ID2ZPLHLYkZDRAzlGbLYFS0Vc7ec5R5AVOHv7OqKfrJvb3LD44YjXZugkiC6VqiRHVMLkgDwXlHkMhmD1sUI6TWf0ygvawiNcBafzDLtZDB0jmNs4kxXCxhV7DHb_amz5yCoV09ZxJKsW9hkZEu4XdsP6XYjrVCZ3Gl7nqR93hCG5ufz6aCpCf8OUhyyzXqcLWfdPJTQ7",
        "sponsored": true,
        "source": "ziprecruiter.co.uk"
      },
      {
        "job_id": "[redacted-phone]",
        "title": "Software Engineer",
        "company": "Hudson Shribman",
        "location": "London, ENG, GB",
        "salary": {
          "min": 50000,
          "max": null,
          "currency": "GBP",
          "period": "year",
          "raw": "£50k",
          "source": "text"
        },
        "posted_date": "02 Jul",
        "snippet": "Job Description Software Engineer £50k Base + Excellent BenefitsRef: ABJ6539Location: Cambridgeshire | PermanentAre you a Software Engineer who enjoys...",
        "url": "https://www.ziprecruiter.co.uk/jobs/[redacted-phone]",
        "apply_url": "https://www.alertsclk.com/ekn/AAKDCjXcBL5eHb9QQKobKrPymA7yqYj6CWu-0eFs06XmKp2gZSLs1-8Gn7_uOHmfyDyEAZWH4WghfYCbOKW2bpSMKq1h4LW6xw76DCyfpsrFaulZdnUNtW6dShWOOfVw2Qz5n3WZAx5mvj9xA3p13WJnQHUHFCOlRbnCB6CS4p3F2yZ1WCRL8bHUr-pdws69WKzk6r7aM36Bwk2tfNvihBAKP7TITfkmlrXj3BTfqKM7yFy4hMXGMlbF7i4fTgcbd8bZsZNf19vTNGA-_qRtHhT0UFJ1aVJrQWJ1tqbnzr_yidcVMgdqtYTHAjztXy1WRMmdCPmq_oASRzqKVb11XizJKEPuw3T50NBNbA3obIqP8uuBPMJl4jo_cyPkoKENfnV1DXgSZUr7Znu8rQqM4zGZafIGLcjq1zOxXoPdWrZWP1BTL5R9MI87bPD0JyRcNCFNQIAALp8PDZM6rLniqGgiJcgnMt0dNvEfqhD4oWSw9LAZJsxMY9pIMZg0GsuZYEeY6-pBGuTPxbFHaI4slfVyTGU5rQPHDVRjQ82s2wUeRO1aA14ug5Cz0y",
        "sponsored": true,
        "source": "ziprecruiter.co.uk"
      }
    ]
  }
}

Actions

What the ZipRecruiter API does

Action	Description	Concrete use case	Key params
search	Search live ZipRecruiter job listings by keyword and location, with pagination and an optional remote-only filter. Each result includes the title, company, location, salary (when posted), posting date, a snippet, the on-site job URL and the apply link. Covers the United Kingdom (ziprecruiter.co.uk), Ireland (ziprecruiter.ie) and Germany (ziprecruiter.de).	Recruiting teams call search to search live ZipRecruiter job listings by keyword and location, with pagination and an optiona….	query, location, country, page, max_results, ...
job_detail	Full ZipRecruiter job posting by job ID (or URL): title, company, location, salary range, employment type, remote flag, posting & expiry dates, the full description, an extracted requirements list and the apply link.	Labor-market analysts call job_detail to get full ZipRecruiter job posting by job ID (or URL).	job_id, url, country
jobs_by_company	List a specific employer's open jobs on ZipRecruiter. Pass a company name; the engine searches and keeps only listings whose employer matches (ZipRecruiter's country sites have no dedicated company page, so this is a best-effort name match over the search results). Optionally narrow by location.	Job boards call jobs_by_company to list a specific employer's open jobs on ZipRecruiter.	company, location, country, page, max_results

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/ziprecruiter/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"software engineer","location":"London","country":"gb","max_results":20}'

import requests

r = requests.post(
    "https://api.reefapi.com/ziprecruiter/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "software engineer",
  "location": "London",
  "country": "gb",
  "max_results": 20
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/ziprecruiter/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "software engineer",
  "location": "London",
  "country": "gb",
  "max_results": 20
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.ziprecruiter.search with {"query":"software engineer","location":"London","country":"gb","max_results":20}.

Use cases

Who uses this API and why

Job boards call search to aggregate fresh ZipRecruiter listings with salary data.
Compensation tools use the salary range to benchmark pay for a role and location.
Sales-intelligence teams use jobs_by_company to detect hiring signals at target accounts.

FAQ

Questions developers ask before integrating

What is the ZipRecruiter API?

ZipRecruiter API is a ReefAPI endpoint group for job listings with full details. It returns live JSON through POST requests under /ziprecruiter/v1.

Is the ZipRecruiter API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. ZipRecruiter calls use the same shared credit balance as every other ReefAPI engine.

Do I need a ZipRecruiter login or account?

No login to ZipRecruiter is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the ZipRecruiter data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the ZipRecruiter API use?

ZipRecruiter actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call ZipRecruiter from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call ziprecruiter actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the ZipRecruiter API a ZipRecruiter scraper?

It is the managed alternative to a DIY ZipRecruiter scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same job listings with full details back as clean JSON.

Why does my ZipRecruiter scraper keep getting blocked?

Most ZipRecruiter scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / ziprecruiter

ZipRecruiter

Job listings with full details.

base /ziprecruiter/v13 endpoints

post/ziprecruiter/v1/search1 credit

Search live ZipRecruiter job listings by keyword and location, with pagination and an optional remote-only filter. Each result includes the title, company, location, salary (when posted), posting date, a snippet, the on-site job URL and the apply link. Covers the United Kingdom (ziprecruiter.co.uk), Ireland (ziprecruiter.ie) and Germany (ziprecruiter.de).

Parameter		Allowed / range	Description
query	required	—	Free-text job keyword: job title or skill — e.g. 'software engineer', 'registered nurse', 'marketing manager'. Matched against the whole posting (title + description), so 'python' finds Python roles.
location	optional	—	City or region to search in (e.g. 'London', 'Dublin', 'Berlin'). Leave empty to search the whole country.
country = gb	optional	gb · ie · de · us	ZipRecruiter country edition to search. gb (United Kingdom), ie (Ireland) and de (Germany) are fully live (bare-DC SSR). us (United States) is not yet available — the US site is a JavaScript app behind an anti-bot wall (a us call returns a clear TARGET_BLOCKED). Other two-letter codes are passed through as-is.
page = 1	optional	1–	Result page to start from, beginning at 1 (20 jobs per page). Use this to page through results — it is the single pagination control.
max_results = 20	optional	1–200	How many job listings to return, paging internally from `page` (1–200).
remote = false	optional	—	If true, keep only remote / work-from-home listings. ZipRecruiter's country sites expose no server-side remote filter, so this is applied by matching each listing's title and location (the engine pages further to still fill `max_results`).

Try in playground →

post/ziprecruiter/v1/job_detail1 credit

Full ZipRecruiter job posting by job ID (or URL): title, company, location, salary range, employment type, remote flag, posting & expiry dates, the full description, an extracted requirements list and the apply link.

Parameter		Allowed / range	Description
job_id	required	—	ZipRecruiter numeric job ID — the `job_id` returned by the search action (or the number in a ziprecruiter.co.uk/jobs/<id> URL). Provide job_id OR url.
url	optional	—	Full ZipRecruiter job URL — alternative to job_id (the ID is extracted automatically).
country = gb	optional	gb · ie · de · us	ZipRecruiter country edition to search. gb (United Kingdom), ie (Ireland) and de (Germany) are fully live (bare-DC SSR). us (United States) is not yet available — the US site is a JavaScript app behind an anti-bot wall (a us call returns a clear TARGET_BLOCKED). Other two-letter codes are passed through as-is.

Try in playground →

post/ziprecruiter/v1/jobs_by_company1 credit

List a specific employer's open jobs on ZipRecruiter. Pass a company name; the engine searches and keeps only listings whose employer matches (ZipRecruiter's country sites have no dedicated company page, so this is a best-effort name match over the search results). Optionally narrow by location.

Parameter		Allowed / range	Description
company	required	—	Employer name to list open jobs for (e.g. 'Amazon', 'NHS', 'Deloitte').
location	optional	—	City or region to search in (e.g. 'London', 'Dublin', 'Berlin'). Leave empty to search the whole country.
country = gb	optional	gb · ie · de · us	ZipRecruiter country edition to search. gb (United Kingdom), ie (Ireland) and de (Germany) are fully live (bare-DC SSR). us (United States) is not yet available — the US site is a JavaScript app behind an anti-bot wall (a us call returns a clear TARGET_BLOCKED). Other two-letter codes are passed through as-is.
page = 1	optional	1–	Result page to start from, beginning at 1 (20 jobs per page). Use this to page through results — it is the single pagination control.
max_results = 20	optional	1–200	How many job listings to return, paging internally from `page` (1–200).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/ziprecruiter/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"software engineer","location":"London","country":"gb","max_results":20}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}