{ "openapi": "3.0.0", "info": { "title": "Real-Time ZipRecruiter Data", "version": "1.0.0", "description": "Fast and Reliable ZipRecruiter Job Search, Full Job Details, and Salary Estimates in\nReal-Time - Job Descriptions, Salaries, Benefits, Employer Ratings, Pay Distributions, and\nMore, across the United States and Canada.\n\nSourced from ZipRecruiter's public job and salary pages (`www.ziprecruiter.com`) and served by\nthe standalone `ziprecruiter_jobs_api` Lambda. Every number in this document was measured on\nlive traffic on 2026-09-14.\n\nThree endpoints:\n\n* `GET /search` - keyword job search with the filters ZipRecruiter honors server-side,\n including scoping every result to one company with `company_id`.\n* `GET /job-details` - full detail for up to 20 job ids in one call.\n* `GET /estimated-salary` - the pay distribution for a job title, nationally or in one US state\n or Canadian province, with the real median instead of the mean ZipRecruiter mislabels as one.\n\n## Coverage: United States and Canada only\n\nZipRecruiter serves exactly two markets and both come off the same host. `ziprecruiter.co.uk`\nhas no job-search route at all, `ziprecruiter.ca` answers with a 4-byte 403, and a\n`London, UK` location on the main host returns zero jobs. `country` therefore accepts only\n`us` and `ca`; anything else is a 400 rather than an empty result set dressed up as a working\nsearch.\n\n## Job object contract\n\nJob objects are a superset of the JSearch `/search` contract. All 35 JSearch keys are present\non every job (`null`, `[]` or `{}` where ZipRecruiter has no equivalent, never omitted), plus\n25 ZipRecruiter-only extras, for 60 keys in total. A consumer that builds columns from the\nobject keys never sees the width change.\n\n## Measured fill rates\n\nOver 507 job objects:\n\n| field | fill | note |\n| --- | --- | --- |\n| `job_id` `job_title` `employer_name` `job_publisher` `job_uid` `job_apply_link` `apply_options` | 100% | |\n| `job_location` `job_city` `job_state` `job_country` | 100% | |\n| `job_posted_at` `job_posted_at_timestamp` `job_posted_at_datetime_utc` | 100% | |\n| `job_is_remote` `ziprecruiter_location_type` `ziprecruiter_apply_type` | 100% | |\n| salary block (`job_salary` `job_salary_string` `job_min_salary` `job_max_salary` `job_salary_period`) | 69% | only when ZipRecruiter itself displays it, see below |\n| `employer_logo` | 69% | |\n| `job_benefits` `job_benefits_strings` | 44% | |\n\nOn the DETAIL surface only, which means `/job-details`, or `/search` with\n`include_details=true`:\n\n| field | fill | note |\n| --- | --- | --- |\n| `job_description` `ziprecruiter_description_html` | 100% | |\n| `job_onet_soc` `ziprecruiter_job_industry` `ziprecruiter_valid_through` | 73% | JSON-LD only, and ZipRecruiter ships JSON-LD on 73% of detail pages |\n| `job_highlights` | 72% | |\n| `employer_website` `ziprecruiter_company_size` `ziprecruiter_company_hq` | 54% | company widget only |\n| `employer_reviews` | 14% | Breakroom, on a 1-10 scale |\n\nAlways present and always `null`, on both surfaces, because ZipRecruiter genuinely does not\npublish them anywhere: `job_latitude`, `job_longitude`, `job_onet_job_zone` and\n`job_google_link`. They are emitted rather than omitted so the object width never changes, and\nthey are never invented.\n\n## The salary is the employer's, never a hidden model guess\n\nZipRecruiter attaches a pay range to 99.5% of postings, but on 27% of them that range is its\nown internal model estimate for a job whose employer stated no pay at all, and ZipRecruiter\nitself refuses to display it. Publishing that range would ship a hidden guess as the\nemployer's salary on more than a quarter of every result page. So the salary fields are\npopulated only when ZipRecruiter's own display gate is open, and the provenance travels with\nevery job in `ziprecruiter_salary_source` and `ziprecruiter_salary_is_estimated` so a consumer\ncan filter further.\n\n## What this source deliberately does NOT fake\n\n* **There is no sort parameter.** ZipRecruiter's job search accepts `sort`, `sort_by` and\n `order` and then throws them away: each returned the identical id set as a deliberately\n bogus control parameter. Sending one is a 400 rather than a capability we do not have.\n Results come back in ZipRecruiter's own relevance order.\n\n* **A company NAME is not a filter.** `company` is accepted upstream and ignored in every\n spelling tried, and the results come back full of other employers, so it is a 400. Scoping a\n search to one employer is done with `company_id`, using the `ziprecruiter_company_id` value\n carried on every job, and every returned card is verified against it.\n\n* **`job_apply_is_direct` is always `false`.** Roughly a third of postings apply on\n ZipRecruiter itself, and the rest go through a redirect whose decoded destination is an ad\n network relay far more often than an employer ATS. We cannot tell the two apart without\n following the redirect, so the flag is never claimed. The real signal is\n `ziprecruiter_apply_type`, and the decoded host is published as `ziprecruiter_apply_host`.\n\n* **`job_apply_link` is the canonical ZipRecruiter posting URL**, present on every job, stable\n and free of impression tokens, rather than a decoded destination that is missing on 42% of\n jobs.\n\n* **`radius` is rejected without a `location`.** ZipRecruiter ignores a radius on a\n country-level search, and we could not measure it above the noise, so that combination is an\n error rather than a silent no-op.\n\n## Pagination\n\nPage size is fixed at 20 by ZipRecruiter. The result ceiling is exactly\n`ceil(total_results / 20)`, where `total_results` is ZipRecruiter's own count of matches for\nthe query. That was proved twice, and the largest result set observed anywhere was 946 jobs, so\nroughly 48 pages is the practical maximum. `page` accepts 1 to 50 and `num_pages` fetches that\nmany consecutive pages in one call.\n\nFor a company-scoped search there is no usable ceiling: ZipRecruiter's count is pure noise\nthere, returning everything from 1 to 540 across 20 identical calls, so it is suppressed rather\nthan published. Page until a call comes back short.\n\nZipRecruiter repeats 5.5% to 7.0% of listings across adjacent pages. Those duplicates are\nremoved, so a page can yield fewer than 20 new jobs and the response is always a deduplicated\nset.\n\n## The salary estimate publishes the real median, not the mean\n\nZipRecruiter's salary pages ship a JSON-LD block with a field labelled `median`. It is the\nMEAN. It was byte-identical to the page's own average on 16 of 16 pages measured, and never\nequal to the real median: on Truck Driver it reads 56,348 against a true median of 49,500,\n13.8% high. Every scraper that reads the easy field ships that mean labelled as a median.\n`/estimated-salary` parses the page's own data layer instead, so `median_salary` is the real\nmedian, and ZipRecruiter's figure travels alongside as `ziprecruiter_json_ld_median` so the\ndifference can be audited in the response itself.", "contact": { "name": "OpenWeb Ninja", "url": "https://www.openwebninja.com" } }, "servers": [ { "url": "https://fu91bhzs73.execute-api.us-east-1.amazonaws.com/v1" } ], "paths": { "/search": { "get": { "summary": "Search Jobs", "operationId": "Search Jobs", "description": "Search ZipRecruiter job postings by keyword, with the filters ZipRecruiter honors\nserver-side: `location` with a kilometre `radius`, `date_posted`, `employment_types`,\n`experience_level`, `salary_min` / `salary_max`, `remote_jobs_only`, `zipapply_only` and\n`company_id`.\n\n**`include_details` defaults to `false`, and this is the single most important thing to\nunderstand about this endpoint.** A ZipRecruiter search card carries a roughly\n200-character teaser and nothing more. `job_description`, `job_highlights`,\n`employer_website`, `employer_reviews`, `job_onet_soc`, `ziprecruiter_description_html`,\n`ziprecruiter_job_industry`, `ziprecruiter_valid_through`, `ziprecruiter_ats_identifier`,\n`ziprecruiter_company_size`, `ziprecruiter_company_hq`, `ziprecruiter_company_industries`,\n`ziprecruiter_key_responsibilities` and `ziprecruiter_employer_faq` are all detail-only and\ncome back `null` on a plain search. Set `include_details=true` to fill them. The teaser is\nalways published separately as `ziprecruiter_short_description`, so a card-only response is\nstill useful and is never a truncated description pretending to be a whole one.\n\nFilling the details costs one extra upstream request per job, which is why it is opt-in\nrather than paid for on every search. With `include_details=true`, `num_pages` may be at\nmost 5, which is 100 jobs; a larger value is a 400 rather than a silently truncated answer.\n\n**Pagination** is 20 jobs per page. The ceiling is `ceil(total_results / 20)`, where\n`total_results` is ZipRecruiter's own count of matches, and the largest result set observed\nwas 946 jobs. Duplicates ZipRecruiter repeats across adjacent pages are removed, so a page\nmay yield fewer than 20 new jobs. The response is a flat array and carries no `has_more`\nflag and no result count of its own, so a call returning fewer than `num_pages` x 20 jobs\nis how you know you have reached the end of the result set.\n\n**Scoping to one company** is what `company_id` is for, and the value is the\n`ziprecruiter_company_id` carried on every job, never a company name. ZipRecruiter fails\nthis filter OPEN in two ways, both silent: a bad id returns the full unfiltered search, and\na valid one intermittently drops the filter. Send `location` alongside `company_id`: that is\nwhat keeps the drop rare. Measured on one id with five interleaved repeats per arm, the\nfilter held 5/5 with a location and 1/5 without, and the misses returned 6, 4 and 20\ndistinct employers. So every returned card is checked against the requested id, a page\nthat fails the check is refetched, and an id that never produces\nscoped results is a 404 rather than a page of other employers' jobs. `total_results` is\nsuppressed for a company-scoped search: ZipRecruiter's count is noise there, returning\neverything from 1 to 540 across 20 identical calls. Note that roughly a third of postings\ncarry the placeholder id `zr_missing_company_default`, which is ZipRecruiter's marker for a\nposting with no company record rather than a real company; it is a 404 here, so pick an id\noff a job whose `employer_name` is the company you want.\n\n**There is no sort parameter.** `sort_by`, `sort`, `order` and a `company` NAME are\nrejected with a 400 because ZipRecruiter accepts and ignores them.\n\n**Billing:** `Requests` counts one per requested SERP page, plus one per detail page when\n`include_details=true`. Extra pages walked to refill a page after deduplication, and\nretries of a blocked page, are absorbed and never billed.", "parameters": [ { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "example": "software engineer" }, "description": "Free-text job search query, for example `software engineer` or `registered nurse`.\nExactly one `query` is accepted; a second one is rejected with a 400 rather than\nsilently ignored." }, { "name": "location", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Free-text location, for example `New York, NY` or `Toronto, ON`. This is what drives\ngeography on ZipRecruiter; the proxy exit country does not. Omit it to search the whole\ncountry." }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 }, "description": "1-based page of results to start from. ZipRecruiter returns 20 jobs per page. The real\nceiling is `ceil(total_results / 20)`, and the largest result set observed was 946\njobs.\n\n**Allowed values:** `1-50`\n\n**Default:** `1`" }, { "name": "num_pages", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 1 }, "description": "Number of consecutive pages to fetch starting at `page`. Each page is 20 jobs.\nDuplicate listings ZipRecruiter repeats across pages are removed, so a page may yield\nfewer than 20 new jobs.\n\n**Allowed values:** `1-20`\n\n**Default:** `1`" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "us", "ca" ], "default": "us" }, "description": "Country market to search. Only `us` and `ca` are served: ZipRecruiter has no other\nmarket, and a request for one would return an empty result set that looks like a\nworking search.\n\n**Allowed values:** `us`, `ca`\n\n**Default:** `us`" }, { "name": "date_posted", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "all", "today", "3days", "week", "month" ], "default": "all" }, "description": "Only return jobs posted within this window. Applied by ZipRecruiter server-side, not by\nus, and each window maps exactly onto 1, 3, 7 and 30 days with nothing rounded.\n\n**Allowed values:** `all`, `today`, `3days`, `week`, `month`\n\n**Default:** `all`" }, { "name": "employment_types", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Comma-separated employment types to include, for example `FULLTIME,CONTRACTOR`. Values\nare OR-ed: a job matching any of them is returned. Applied by ZipRecruiter.\n\n**Allowed values:** `FULLTIME`, `PARTTIME`, `CONTRACTOR`, `TEMPORARY`,\n`CONTRACT_TO_HIRE`, `AS_NEEDED`, `OTHER`" }, { "name": "experience_level", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "no_experience", "junior", "mid", "senior" ] }, "description": "Only return jobs at this experience level. A single value; a comma-separated list is\nrejected, because ZipRecruiter's behaviour for multiple levels is unverified. Applied\nby ZipRecruiter.\n\n**Allowed values:** `no_experience`, `junior`, `mid`, `senior`" }, { "name": "remote_jobs_only", "in": "query", "required": false, "schema": { "type": "boolean", "default": false }, "description": "Set to `true` to return only remote jobs. Applied by ZipRecruiter server-side, so\nrecall is ZipRecruiter's own remote classification rather than a text match we perform.\n\n**Default:** `false`" }, { "name": "salary_min", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "Minimum ANNUAL salary in whole dollars, for example `80000`. Jobs with no\nemployer-stated salary are excluded by ZipRecruiter when this is set." }, { "name": "salary_max", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "Maximum ANNUAL salary in whole dollars, for example `150000`. Must be greater than or\nequal to `salary_min`." }, { "name": "radius", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Search radius around `location`, in KILOMETRES, converted to the miles ZipRecruiter\nexpects. Any positive integer is accepted and is not snapped to a fixed menu. Requires\n`location`. ZipRecruiter's own default is 25 miles." }, { "name": "zipapply_only", "in": "query", "required": false, "schema": { "type": "boolean", "default": false }, "description": "Set to `true` to return only jobs that support ZipApply, ZipRecruiter's one-click\napply. Applied by ZipRecruiter.\n\n**Default:** `false`" }, { "name": "company_id", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Return only jobs from one company. Use the `ziprecruiter_company_id` from a previous\n`/search` result, not a company name. Send `location` too: without it ZipRecruiter\napplies this filter much less reliably. Every card is verified: an unknown id is a 404,\nnever unrelated jobs. `total_results` is not published." }, { "name": "include_details", "in": "query", "required": false, "schema": { "type": "boolean", "default": false }, "description": "Set to `true` to fetch each job's full description and detail-only fields. Costs one\nextra request per job, so it is much slower and is billed accordingly. Caps `num_pages`\nat 5.\n\n**Default:** `false`" }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Comma-separated projection over the job object, for example\n`job_title,employer_name,job_apply_link`. `job_id` and `job_title` are always included.\nAn unknown field name is a 400." } ], "responses": { "200": { "description": "Matching jobs.", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "request_id", "parameters", "data" ], "properties": { "status": { "type": "string", "enum": [ "OK" ] }, "request_id": { "type": "string", "description": "Unique id for this request, useful when contacting support.", "example": "0729a0b8-8e36-43b7-9a78-900bea6daee1" }, "parameters": { "$ref": "#/components/schemas/SearchParameters" }, "data": { "type": "array", "description": "Matching jobs, deduplicated, in ZipRecruiter's own relevance order for the\nrequested window.", "items": { "$ref": "#/components/schemas/Job" } } } }, "example": { "status": "OK", "request_id": "0729a0b8-8e36-43b7-9a78-900bea6daee1", "parameters": { "query": "software engineer", "location": "New York, NY", "page": 1, "num_pages": 1, "country": "us", "date_posted": "all", "remote_jobs_only": false, "zipapply_only": false, "include_details": "true" }, "data": [ { "job_id": "emlwcmVjcnVpdGVyOjkzNjIxNWNiNTAzZDhiZTI", "job_title": "Senior AI Engineer (AI Foundations)", "employer_name": "Capital One", "employer_logo": "https://www.ziprecruiter.com/svc/fotomat/public-nosensitive-ziprecruiter-logos/company/60122984.png", "employer_website": "https://capitalone.com", "job_publisher": "ZipRecruiter", "job_employment_type": "FULLTIME", "job_employment_types": [ "FULLTIME" ], "job_apply_link": "https://www.ziprecruiter.com/c/Capital-One/Job/Senior-AI-Engineer-(AI-Foundations)/-in-Manhattan,NY?jid=936215cb503d8be2", "job_apply_is_direct": false, "apply_options": [ { "publisher": "ZipRecruiter", "apply_link": "https://www.ziprecruiter.com/c/Capital-One/Job/Senior-AI-Engineer-(AI-Foundations)/-in-Manhattan,NY?jid=936215cb503d8be2", "is_direct": false } ], "job_description": "Senior AI Engineer (AI Foundations)\n\nOverview:\n\nAt Capital One, we are creating responsible and reliable AI systems, changing banking for good. ...", "job_is_remote": false, "job_posted_at": "4 days ago", "job_posted_at_timestamp": 1788992809, "job_posted_at_datetime_utc": "2026-09-09T22:26:49.000Z", "job_location": "Manhattan, NY", "job_city": "Manhattan", "job_state": "New York", "job_country": "US", "job_latitude": null, "job_longitude": null, "job_benefits": null, "job_benefits_strings": null, "job_google_link": null, "job_salary": 155750, "job_salary_string": "$134K - $177K/yr", "job_min_salary": 134400, "job_max_salary": 177100, "job_salary_period": "YEAR", "job_highlights": { "Responsibilities": [ "Design, develop, test, deploy, and support AI software components including foundation model training, large language model inference, similarity search, guardrails, model evaluation, experimentation, governance, and observability." ], "Qualifications": [ "At least 3 years of experience programming with Python, Go, Scala, or Java" ] }, "job_onet_soc": "15-1132.00", "job_onet_job_zone": null, "employer_reviews": [ { "publisher": "Breakroom", "employer_name": "Capital One", "score": 7.76, "num_stars": 8, "review_count": 148, "max_score": 10, "reviews_link": "https://breakroom.cc/companies/capital-one" } ], "job_uid": "936215cb503d8be2", "ziprecruiter_listing_key": "nl4pTJGdpooiHxf1Uq5XRw", "ziprecruiter_short_description": "Senior AI Engineer (AI Foundations) Overview: At Capital One, we are creating responsible and reliable AI systems, changing banking for good.", "ziprecruiter_description_html": "Senior AI Engineer (AI Foundations)

Overview:

At Capital One, we are creating responsible ...

Overview:

At Capital One, we are creating responsible ...

", "ziprecruiter_share_url": "https://www.ziprecruiter.com/job-redirect/share?match_token=CqABChZubDRwVEpHZHBvb2lIeGYxVXE1WFJ3", "ziprecruiter_canonical_job_url": "https://www.ziprecruiter.com/c/Capital-One/Job/Senior-AI-Engineer-(AI-Foundations)/-in-Manhattan,NY?jid=936215cb503d8be2", "ziprecruiter_updated_at": null, "ziprecruiter_is_new": null, "ziprecruiter_apply_type": "OPEN_EXTERNAL", "ziprecruiter_apply_host": "dsp.prng.co", "ziprecruiter_salary_source": "SOURCE_PREDICTED", "ziprecruiter_salary_is_estimated": true, "ziprecruiter_location_type": "LOCATION_TYPE_NAME_IN_PERSON", "ziprecruiter_location_county": "New York", "ziprecruiter_location_postal_code": "10012", "ziprecruiter_location_id": "0a070499-f1f0-42d9-940e-76c39915e34a", "ziprecruiter_company_id": "LvOba8F2oEpGlw2IxG/RnmjRZMM=", "ziprecruiter_company_slug": "capital one", "ziprecruiter_company_size": "10000+ Employees", "ziprecruiter_company_hq": "McLean, VA, US", "ziprecruiter_company_industries": [ "Funds, Trusts and Financial Programs", "Real Estate" ], "ziprecruiter_job_industry": "Technology", "ziprecruiter_valid_through": "2026-10-14", "ziprecruiter_ats_identifier": "R1000242", "ziprecruiter_key_responsibilities": null, "ziprecruiter_employer_faq": [ { "question": "What skills or qualities help someone succeed as a Senior Software Engineer?", "answer": "Key technical skills include expertise in programming languages such as Java, Python, or C++, as well as proficiency in software development methodologies like Agile and DevOps." } ] } ] } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" }, "503": { "$ref": "#/components/responses/TemporaryError" } } } }, "/estimated-salary": { "get": { "summary": "Estimated Salary", "operationId": "Estimated Salary", "description": "The pay distribution ZipRecruiter publishes for a job title, nationally or in one US state\nor Canadian province. One upstream page, one row, no pagination.\n\nThe row carries the house `/estimated-salary` contract keys, plus 18 `ziprecruiter_*`\nextras with no house equivalent.\n\n**The median is the real median.** ZipRecruiter's own JSON-LD publishes a field labelled\n`median` that is actually the MEAN: it was byte-identical to the page's average on 16 of 16\npages measured, and on Truck Driver it reads 56,348 against a true median of 49,500, which\nis 13.8% high. Every scraper that reads the easy JSON-LD field ships that mean labelled as\na median. `median_salary` here is parsed out of the page's own data layer and is the real\nmedian; ZipRecruiter's figure is carried alongside as `ziprecruiter_json_ld_median` so the\ndifference is auditable in the response itself rather than taken on trust.\n\n**Figures are always annual**, `salary_period` is always `YEAR`, and that is deliberate.\nZipRecruiter leads 6 of 11 titles measured with an hourly figure, but its own structured\ndata is annual (`P1Y`) on 13 of 13 pages, including every hourly-preferring title. Driving\nthe row off the page's preference would make `median_salary` mean something different for\nTruck Driver than for Data Scientist. All four frequencies ride along in\n`ziprecruiter_pay_frequencies`, and the page's own preference is preserved as\n`ziprecruiter_preferred_pay_period`.\n\n**Eight contract fields are always `null`,** because ZipRecruiter genuinely does not\npublish them: `min_base_salary`, `max_base_salary`, `median_base_salary`,\n`min_additional_pay`, `max_additional_pay` and `median_additional_pay` (there is no\nbase-versus-additional split anywhere on this surface), `salary_count` (no sample size is\nstated, and the open-listing count is a different quantity, published as\n`ziprecruiter_total_listings`) and `confidence` (no estimator confidence is stated, and\n`ziprecruiter_spread_level` describes the spread of the top-city figures, not confidence).\nThey are present rather than omitted so the row width never changes.\n\n**What only this source has:** p25 and p75, an 11-bucket salary histogram that is a real\ndistribution rather than a range, a 59 to 64 row state and province table, the 10\ntop-paying cities, 5 related titles with pay deltas, all four pay frequencies on one row,\nthe count of open listings behind the figures, the spread level, ZipRecruiter's own summary\nprose and its generated FAQ.\n\n**Coverage is national and state or province level only.** A city is rejected with a 400\nbefore any request is made rather than silently answered with the state figure: ZipRecruiter\nhas no city salary pages at all. `location_type` and `years_of_experience`, which JSearch\noffers, are rejected with a 400 here, because this source has nothing for either of them to\nselect and accepting a parameter we then ignore would be worse than not offering it.\n\nA title ZipRecruiter has never published, or a title with no figures for the requested\nstate, is a 404. A state page missing for one title does not mean the state name is wrong:\n`Software-Engineer` has an Ontario page and `Truck-Driver` does not.\n\n**Billing:** `Requests` counts 1. There is no pagination and no per-row cost.", "parameters": [ { "name": "job_title", "in": "query", "required": true, "schema": { "type": "string", "example": "Registered Nurse" }, "description": "Job title to price, for example `Registered Nurse`. Matched against ZipRecruiter's own\nsalary pages, so a title it does not publish returns 404 rather than an approximation." }, { "name": "location", "in": "query", "required": false, "schema": { "type": "string" }, "description": "US state, Canadian province or country, spelled out in full, for example `New York` or\n`Alberta`. Two-letter codes and city names are rejected with a 400: ZipRecruiter\npublishes no city-level figures. Omit for the national figure.\n\n**Default:** nationwide" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "us", "ca" ], "default": "us" }, "description": "Country market the figures belong to. Only `us` and `ca` are served, because\nZipRecruiter has no other market.\n\n**Allowed values:** `us`, `ca`\n\n**Default:** `us`" }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Comma-separated projection over the salary row, for example\n`median_salary,salary_period`. `job_title` and `location` are always included. An\nunknown field name is a 400. Job object field names are not valid here." } ], "responses": { "200": { "description": "One salary row for the requested title and scope.", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "request_id", "parameters", "data" ], "properties": { "status": { "type": "string", "enum": [ "OK" ], "description": "Always `OK` on a successful request." }, "request_id": { "type": "string", "description": "Unique id for this request, useful when contacting support.", "example": "c6f1a2ee-6d77-4f7e-9f65-1b9f6a5f2d31" }, "parameters": { "$ref": "#/components/schemas/EstimatedSalaryParameters" }, "data": { "type": "array", "description": "Exactly one salary row. An array rather than an object so the shape matches\nevery other endpoint on this API and the house `/estimated-salary` contract.", "items": { "$ref": "#/components/schemas/EstimatedSalary" } } } }, "example": { "status": "OK", "request_id": "c6f1a2ee-6d77-4f7e-9f65-1b9f6a5f2d31", "parameters": { "job_title": "Registered Nurse", "country": "us" }, "data": [ { "location": "United States", "job_title": "RN", "min_salary": 56000, "max_salary": 131000, "median_salary": 82000, "min_base_salary": null, "max_base_salary": null, "median_base_salary": null, "min_additional_pay": null, "max_additional_pay": null, "median_additional_pay": null, "salary_period": "YEAR", "salary_currency": "USD", "salary_count": null, "salaries_updated_at": "2026-09-12T00:00:00.000Z", "publisher_name": "ZipRecruiter", "publisher_link": "https://www.ziprecruiter.com/Salaries/Registered-Nurse-Salary", "confidence": null, "ziprecruiter_average_salary": 87868, "ziprecruiter_national_average_salary": 87868, "ziprecruiter_p25_salary": 65500, "ziprecruiter_p75_salary": 104000, "ziprecruiter_pay_frequencies": { "year": { "salary_period": "YEAR", "average_salary": 87868, "national_average_salary": 87868, "median_salary": 82000, "p10_salary": 56000, "p25_salary": 65500, "p75_salary": 104000, "p90_salary": 131000, "average_salary_delta": 38500 }, "month": { "salary_period": "MONTH", "average_salary": 7322, "national_average_salary": 7322, "median_salary": 6833, "p10_salary": 4666, "p25_salary": 5458, "p75_salary": 8666, "p90_salary": 10916, "average_salary_delta": 3208 }, "week": { "salary_period": "WEEK", "average_salary": 1689, "national_average_salary": 1689, "median_salary": 1576, "p10_salary": 1076, "p25_salary": 1259, "p75_salary": 2000, "p90_salary": 2519, "average_salary_delta": 740 }, "hour": { "salary_period": "HOUR", "average_salary": 42.244232, "national_average_salary": 42.244232, "median_salary": 39, "p10_salary": 26, "p25_salary": 31.490385, "p75_salary": 50, "p90_salary": 62, "average_salary_delta": 18 } }, "ziprecruiter_salary_histogram": { "bucket_count": 11, "bucket_min_list": [ 15500, 27500, 40000, 52000, 64000, 76500, 88500, 101000, 113000, 125000, 137500 ], "bucket_probability_list": [ 0.0069, 0.0048, 0.0464, 0.1761, 0.196, 0.1757, 0.1506, 0.0964, 0.0644, 0.0482, 0.0345 ], "buckets": [ { "min_salary": 15500, "max_salary": 27500, "probability": 0.0069 }, { "min_salary": 64000, "max_salary": 76500, "probability": 0.196 }, { "min_salary": 137500, "max_salary": null, "probability": 0.0345 } ] }, "ziprecruiter_salaries_by_state": [ { "state": "Washington", "annual_salary": 99519, "monthly_pay": 8293, "weekly_pay": 1913, "hourly_wage": 47.85, "difference_from_average": 11651, "difference_percent": 13.26 }, { "state": "District of Columbia", "annual_salary": 99293, "monthly_pay": 8274, "weekly_pay": 1909, "hourly_wage": 47.74, "difference_from_average": 11425, "difference_percent": 13 } ], "ziprecruiter_top_paying_cities": [ { "city": "San Mateo County, CA", "annual_salary": 129338, "monthly_pay": 10778, "weekly_pay": 2487, "hourly_wage": 62.18, "difference_from_average": 41470, "difference_percent": 47.2, "state": null } ], "ziprecruiter_related_titles": [ { "job_title": "Vice President Home Health Registered Nurse", "annual_salary": 165372, "monthly_pay": 13781, "weekly_pay": 3180, "hourly_wage": 79.51, "difference_from_average": 77504, "difference_percent": 88.21 } ], "ziprecruiter_total_listings": 506, "ziprecruiter_spread_level": "large", "ziprecruiter_location_granularity": "NATIONAL", "ziprecruiter_preferred_pay_period": "HOUR", "ziprecruiter_job_title_searched": "Registered Nurse", "ziprecruiter_salaries_updated_at_text": "September 12 2026", "ziprecruiter_summary": "The average annual pay for a registered nurse in the United States is $87,868 a year...", "ziprecruiter_faq": [ { "question": "How much does a Registered Nurse make?", "answer": "The average annual pay for a registered nurse in the United States is $87,868 a year..." } ], "ziprecruiter_json_ld_median": 87868 } ] } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" }, "503": { "$ref": "#/components/responses/TemporaryError" } } } } }, "components": { "responses": { "BadRequest": { "description": "Invalid or missing parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "noSortParameter": { "summary": "A sort was requested, and this source has none", "value": { "status": "ERROR", "request_id": "d06a1162-235f-49e4-9774-1880ffd4c9df", "error": { "message": "The 'sort_by' parameter is not supported: ZipRecruiter's job search has no sort parameter, and results are returned in ZipRecruiter's own relevance order.", "code": 400 } } }, "companyNameIsNotAFilter": { "summary": "A company NAME is a no-op upstream; use company_id", "value": { "status": "ERROR", "request_id": "59833f2a-5afd-41b9-a6b9-ef96c75a4229", "error": { "message": "The 'company' parameter is not supported: ZipRecruiter ignores a company-name filter and returns jobs from other employers. Use 'company_id' with the 'ziprecruiter_company_id' value from a previous search result.", "code": 400 } } }, "salaryLocationMustBeSpelledOut": { "summary": "A two-letter state code on /estimated-salary", "value": { "status": "ERROR", "request_id": "8b1c5f22-0b5e-4f0e-9a21-3c7f1d4e6a09", "error": { "message": "location must be a full, spelled-out US state or Canadian province name (for example \"New York\", not \"NY\"), or omitted for the national figure.", "code": 400 } } }, "salaryCityNotSupported": { "summary": "A city on /estimated-salary, rejected instead of degraded to its state", "value": { "status": "ERROR", "request_id": "1f0d9a4c-6b2e-4c31-8d55-0a7c2e9b4411", "error": { "message": "ZipRecruiter salary data is national and state level only. Pass a full state or province name (for example \"New York\"), or omit location for the national figure. City-level estimates do not exist on this source and are not silently substituted with the state figure.", "code": 400 } } }, "salaryLocationTypeNotSupported": { "summary": "A JSearch parameter this source cannot honor", "value": { "status": "ERROR", "request_id": "2c8e17a5-90d4-4f6b-9a0e-6b1d3f5c8027", "error": { "message": "The 'location_type' parameter is not supported: ZipRecruiter publishes salary figures nationally and by state or province only, so there is nothing for it to select.", "code": 400 } } }, "salaryYearsOfExperienceNotSupported": { "summary": "A JSearch parameter this source cannot honor", "value": { "status": "ERROR", "request_id": "7a53b0d1-4e92-4a1c-b6f8-3d2e91c7a544", "error": { "message": "The 'years_of_experience' parameter is not supported: ZipRecruiter's salary pages carry no experience breakdown.", "code": 400 } } }, "radiusWithoutLocation": { "summary": "radius needs a location to apply to", "value": { "status": "ERROR", "request_id": "4181095c-3286-4b48-804b-15e58e19cc4f", "error": { "message": "The 'radius' parameter requires 'location'. ZipRecruiter ignores a radius when the search is country-level.", "code": 400 } } }, "unsupportedCountry": { "summary": "Only the US and Canada are served", "value": { "status": "ERROR", "request_id": "aac8ee2e-7aaf-4260-ba30-f298d44862d5", "error": { "message": "The 'country' parameter should be one of: us, ca. ZipRecruiter serves no other market.", "code": 400 } } } } } } }, "Unauthorized": { "description": "Missing or invalid credentials.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "Forbidden": { "description": "Not subscribed to this API.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "NotFound": { "description": "The requested resource does not exist. On `/search` this is a `company_id` that never\nproduced scoped results, and on `/estimated-salary` it is a job title, or a title and state\npair, that ZipRecruiter publishes no figures for.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "unknownCompanyId": { "summary": "A company_id that never produced scoped results", "value": { "status": "ERROR", "request_id": "5d7f2b31-9c48-4e0a-b1d6-8f3a2c4e7069", "error": { "message": "No jobs found for that company_id, or the id is not valid. Copy ziprecruiter_company_id from a previous /search result.", "code": 404 } } }, "unknownSalaryTitle": { "summary": "A job title ZipRecruiter publishes no salary page for", "value": { "status": "ERROR", "request_id": "9b4c6e28-1a70-4d35-8e92-7c0f5d1b3a86", "error": { "message": "ZipRecruiter has no salary figures for \"Chief Dragon Wrangler\" nationally. Check the job title spelling, or try a broader title.", "code": 404 } } } } } } }, "TooManyRequests": { "description": "Quota exhausted or rate limit hit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "ServerError": { "description": "Unexpected error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "TemporaryError": { "description": "ZipRecruiter was temporarily unreachable after the full proxy ladder was exhausted, so no\npage was ever read. Returned instead of an empty result set, because 'no jobs found' and\n'we could not see the page' are different answers. Safe to retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "ERROR", "request_id": "35dabdcd-b334-4600-afbc-d654b8af91cf", "error": { "message": "ZipRecruiter is temporarily unavailable, please retry", "code": 503 } } } } } }, "schemas": { "ErrorResponse": { "type": "object", "required": [ "status", "request_id", "error" ], "properties": { "status": { "type": "string", "enum": [ "ERROR" ], "description": "Always `ERROR` on a failed request." }, "request_id": { "type": "string", "description": "Unique id for this request, useful when contacting support.", "example": "35dabdcd-b334-4600-afbc-d654b8af91cf" }, "error": { "type": "object", "required": [ "message", "code" ], "description": "What went wrong.", "properties": { "message": { "type": "string", "description": "Human-readable explanation, naming the parameter and the allowed values.", "example": "The 'query' parameter is required." }, "code": { "type": "integer", "description": "HTTP status code, repeated in the body.", "example": 400 } } } } }, "SearchParameters": { "type": "object", "description": "Echo of the parameters as the caller sent them, before any internal transformation.\n`date_posted` is echoed as `all` even though no upstream window is sent for it, and\n`radius` is echoed in kilometres even though miles are sent upstream. Only the parameters\nactually supplied are present, except the four that always carry their resolved default.\n`remote_jobs_only`, `zipapply_only` and `include_details` echo the boolean `false` when the\ncaller omitted them and the caller's raw string when the caller supplied them.", "required": [ "query", "page", "num_pages", "country", "date_posted", "remote_jobs_only", "zipapply_only", "include_details" ], "properties": { "query": { "type": "string", "description": "The search query, trimmed.", "example": "software engineer" }, "location": { "type": "string", "description": "The location as sent, trimmed. Absent when no location was supplied.", "example": "New York, NY" }, "page": { "type": "integer", "description": "The first page fetched.", "example": 1 }, "num_pages": { "type": "integer", "description": "How many consecutive pages were requested.", "example": 1 }, "country": { "type": "string", "enum": [ "us", "ca" ], "description": "The resolved country market, lowercased.", "example": "us" }, "date_posted": { "type": "string", "enum": [ "all", "today", "3days", "week", "month" ], "description": "The resolved date window, lowercased.", "example": "all" }, "employment_types": { "type": "string", "description": "The employment type list exactly as sent. Absent when not supplied.", "example": "FULLTIME,CONTRACTOR" }, "experience_level": { "type": "string", "description": "The experience level exactly as sent. Absent when not supplied.", "example": "senior" }, "remote_jobs_only": { "description": "The boolean `false` when the parameter was not supplied, otherwise the raw string\nexactly as the caller sent it.", "example": false }, "salary_min": { "type": "integer", "description": "The minimum annual salary as an integer. Absent when not supplied.", "example": 80000 }, "salary_max": { "type": "integer", "description": "The maximum annual salary as an integer. Absent when not supplied.", "example": 150000 }, "radius": { "type": "integer", "description": "The radius in KILOMETRES as sent, before conversion to miles.", "example": 40 }, "zipapply_only": { "description": "The boolean `false` when the parameter was not supplied, otherwise the raw string\nexactly as the caller sent it.", "example": false }, "company_id": { "type": "string", "description": "The company id exactly as sent, trimmed. Absent when not supplied.", "example": "veWDjg7imzXye0FSbif3ZyRHsGc=" }, "include_details": { "description": "The boolean `false` when the parameter was not supplied, otherwise the raw string\nexactly as the caller sent it.", "example": "true" }, "fields": { "type": "string", "description": "The projection exactly as sent. Absent when not supplied.", "example": "job_title,employer_name" } } }, "JobDetailsParameters": { "type": "object", "description": "Echo of the parameters as the caller sent them.", "required": [ "job_id", "country" ], "properties": { "job_id": { "type": "string", "description": "The id list exactly as sent, before splitting and deduplication.", "example": "emlwcmVjcnVpdGVyOjkzNjIxNWNiNTAzZDhiZTI" }, "country": { "type": "string", "enum": [ "us", "ca" ], "description": "The resolved country market, lowercased.", "example": "us" }, "fields": { "type": "string", "description": "The projection exactly as sent. Absent when not supplied.", "example": "job_title,employer_name" } } }, "EstimatedSalaryParameters": { "type": "object", "description": "Echo of the parameters as the caller sent them, before any internal transformation. Only\nthe parameters actually supplied are present, except `country`, which always carries its\nresolved default.", "required": [ "job_title", "country" ], "properties": { "job_title": { "type": "string", "description": "The job title exactly as sent, trimmed.", "example": "Registered Nurse" }, "location": { "type": "string", "description": "The location exactly as sent, trimmed. Absent when no location was supplied.", "example": "New York" }, "country": { "type": "string", "enum": [ "us", "ca" ], "description": "The resolved country market, lowercased.", "example": "us" }, "fields": { "type": "string", "description": "The projection exactly as sent. Absent when not supplied.", "example": "median_salary,salary_period" } } }, "PayBlock": { "type": "object", "nullable": true, "description": "One pay frequency, with the full distribution ZipRecruiter publishes for it. `null` when\nZipRecruiter carries no figure at all for that frequency, which was not observed on any\npage measured.", "required": [ "salary_period", "average_salary", "national_average_salary", "median_salary", "p10_salary", "p25_salary", "p75_salary", "p90_salary", "average_salary_delta" ], "properties": { "salary_period": { "type": "string", "enum": [ "HOUR", "WEEK", "MONTH", "YEAR" ], "description": "The period these figures are expressed in. ZipRecruiter has no daily figure, so `DAY`\nis absent rather than divided out of the weekly one.", "example": "YEAR" }, "average_salary": { "type": "number", "nullable": true, "description": "The MEAN for this frequency. This is the number ZipRecruiter's JSON-LD mislabels as its\nmedian; it is published here under its real name.", "example": 87868 }, "national_average_salary": { "type": "number", "nullable": true, "description": "The national mean for this title and frequency. Equal to `average_salary` on a national\nrequest; the national benchmark to compare against on a state request.", "example": 87868 }, "median_salary": { "type": "number", "nullable": true, "description": "The real median for this frequency, read from the page's own data layer.", "example": 82000 }, "p10_salary": { "type": "number", "nullable": true, "description": "10th percentile.", "example": 56000 }, "p25_salary": { "type": "number", "nullable": true, "description": "25th percentile. ZipRecruiter names it 'average low'; it equals the JSON-LD\n`percentile25` on every page measured, so it is published as what it is.", "example": 65500 }, "p75_salary": { "type": "number", "nullable": true, "description": "75th percentile. ZipRecruiter names it 'average high'; it equals the JSON-LD\n`percentile75` on every page measured.", "example": 104000 }, "p90_salary": { "type": "number", "nullable": true, "description": "90th percentile.", "example": 131000 }, "average_salary_delta": { "type": "number", "nullable": true, "description": "ZipRecruiter's own published spread figure for this frequency.", "example": 38500 } } }, "HistogramBucket": { "type": "object", "description": "One bucket of the salary distribution. Bucket `i` spans `[min_salary, max_salary)`; the top\nbucket is open-ended, so its `max_salary` is `null` rather than an invented ceiling.", "required": [ "min_salary", "max_salary", "probability" ], "properties": { "min_salary": { "type": "number", "nullable": true, "description": "Lower bound of the bucket, in annual currency units.", "example": 64000 }, "max_salary": { "type": "number", "nullable": true, "description": "Upper bound, exclusive. `null` on the last bucket, which is open-ended.", "example": 76500 }, "probability": { "type": "number", "nullable": true, "description": "Share of postings in this bucket, as a fraction. The 11 probabilities sum to roughly\n1.0.", "example": 0.196 } } }, "SalaryHistogram": { "type": "object", "nullable": true, "description": "The 11-bucket annual salary distribution ZipRecruiter publishes for the title. A real\ndistribution rather than a min-max range: it shows where the mass actually sits. `null` on\nthe rare page that carries no histogram.", "required": [ "bucket_count", "bucket_min_list", "bucket_probability_list", "buckets" ], "properties": { "bucket_count": { "type": "integer", "description": "Number of buckets. `11` on every page measured.", "example": 11 }, "bucket_min_list": { "type": "array", "description": "The raw lower bounds, in order, as ZipRecruiter publishes them.", "items": { "type": "number", "nullable": true }, "example": [ 15500, 27500, 40000 ] }, "bucket_probability_list": { "type": "array", "description": "The raw probabilities, in the same order as `bucket_min_list`.", "items": { "type": "number", "nullable": true }, "example": [ 0.0069, 0.0048, 0.0464 ] }, "buckets": { "type": "array", "description": "The same data zipped into explicit bounded buckets, which is what most consumers want\nto chart.", "items": { "$ref": "#/components/schemas/HistogramBucket" } } } }, "StateSalary": { "type": "object", "description": "One row of the state and province pay table: 59 to 64 rows covering the 50 US states, the\nDistrict of Columbia and the Canadian provinces and territories. National requests only; an\nempty array on a state request, rather than the national table repeated.", "required": [ "state", "annual_salary", "monthly_pay", "weekly_pay", "hourly_wage", "difference_from_average", "difference_percent" ], "properties": { "state": { "type": "string", "nullable": true, "description": "The state or province name, spelled out. Usable directly as this endpoint's `location`.\nTwo rows use a display spelling that differs from the URL name (`Newfoundland`,\n`Yukon Territory`); both are accepted as `location` values.", "example": "Washington" }, "annual_salary": { "type": "number", "nullable": true, "description": "Average annual pay for the title in this state or province.", "example": 99519 }, "monthly_pay": { "type": "number", "nullable": true, "description": "The same figure expressed monthly.", "example": 8293 }, "weekly_pay": { "type": "number", "nullable": true, "description": "The same figure expressed weekly.", "example": 1913 }, "hourly_wage": { "type": "number", "nullable": true, "description": "The same figure expressed hourly.", "example": 47.85 }, "difference_from_average": { "type": "number", "nullable": true, "description": "This row's annual figure minus the page's own annual mean. Computed for every row,\nbecause ZipRecruiter publishes the delta for only 3 or 4 of them.", "example": 11651 }, "difference_percent": { "type": "number", "nullable": true, "description": "`difference_from_average` as a percentage of the page's annual mean.", "example": 13.26 } } }, "CitySalary": { "type": "object", "description": "One of the 10 top-paying cities for the title: cities across the country on a national\nrequest, cities within the state on a state request. ZipRecruiter ships no link for these\nrows, so none is emitted rather than one being synthesised.", "required": [ "city", "annual_salary", "monthly_pay", "weekly_pay", "hourly_wage", "difference_from_average", "difference_percent", "state" ], "properties": { "city": { "type": "string", "nullable": true, "description": "The city as ZipRecruiter names it, often including the state code. Not usable as this\nendpoint's `location`: there are no city-level salary pages.", "example": "San Mateo County, CA" }, "annual_salary": { "type": "number", "nullable": true, "description": "Average annual pay for the title in this city.", "example": 129338 }, "monthly_pay": { "type": "number", "nullable": true, "description": "The same figure expressed monthly.", "example": 10778 }, "weekly_pay": { "type": "number", "nullable": true, "description": "The same figure expressed weekly.", "example": 2487 }, "hourly_wage": { "type": "number", "nullable": true, "description": "The same figure expressed hourly.", "example": 62.18 }, "difference_from_average": { "type": "number", "nullable": true, "description": "This row's annual figure minus the page's own annual mean.", "example": 41470 }, "difference_percent": { "type": "number", "nullable": true, "description": "`difference_from_average` as a percentage of the page's annual mean.", "example": 47.2 }, "state": { "type": "string", "nullable": true, "description": "The separate state column, which ZipRecruiter ships empty on both page types, so it is\n`null` on every row measured. Carried rather than dropped because the column exists\nupstream.", "example": null } } }, "RelatedTitle": { "type": "object", "description": "One of the 5 related job titles ZipRecruiter lists for the searched title, with how much\nmore or less it pays. Each `job_title` can be fed straight back into this endpoint.", "required": [ "job_title", "annual_salary", "monthly_pay", "weekly_pay", "hourly_wage", "difference_from_average", "difference_percent" ], "properties": { "job_title": { "type": "string", "nullable": true, "description": "The related title, usable directly as this endpoint's `job_title`.", "example": "Vice President Home Health Registered Nurse" }, "annual_salary": { "type": "number", "nullable": true, "description": "Average annual pay for the related title.", "example": 165372 }, "monthly_pay": { "type": "number", "nullable": true, "description": "The same figure expressed monthly.", "example": 13781 }, "weekly_pay": { "type": "number", "nullable": true, "description": "The same figure expressed weekly.", "example": 3180 }, "hourly_wage": { "type": "number", "nullable": true, "description": "The same figure expressed hourly.", "example": 79.51 }, "difference_from_average": { "type": "number", "nullable": true, "description": "This title's annual figure minus the searched title's annual mean. Computed for all 5\nrows; ZipRecruiter publishes only 4 of them.", "example": 77504 }, "difference_percent": { "type": "number", "nullable": true, "description": "`difference_from_average` as a percentage of the searched title's annual mean.", "example": 88.21 } } }, "SalaryFaqItem": { "type": "object", "description": "One entry of ZipRecruiter's generated salary FAQ for this title and scope. Answers that\nquote a table are flattened to text with cells separated by ` | `.", "required": [ "question", "answer" ], "properties": { "question": { "type": "string", "nullable": true, "description": "The question, verbatim.", "example": "How much does a Registered Nurse make?" }, "answer": { "type": "string", "nullable": true, "description": "The answer, HTML stripped to plain text.", "example": "The average annual pay for a registered nurse in the United States is $87,868 a year..." } } }, "EstimatedSalary": { "type": "object", "description": "A salary distribution for one job title and one scope. The 18 house `/estimated-salary`\ncontract keys come first, in contract order, followed by 18 `ziprecruiter_*` extras, for 36\nkeys in total. Every key is always present, `null` or `[]` where ZipRecruiter has no value,\nso the row width never changes. The only thing that narrows it is the `fields` projection,\nwhich returns exactly the keys asked for plus `job_title` and `location`.", "required": [ "location", "job_title", "min_salary", "max_salary", "median_salary", "min_base_salary", "max_base_salary", "median_base_salary", "min_additional_pay", "max_additional_pay", "median_additional_pay", "salary_period", "salary_currency", "salary_count", "salaries_updated_at", "publisher_name", "publisher_link", "confidence", "ziprecruiter_average_salary", "ziprecruiter_national_average_salary", "ziprecruiter_p25_salary", "ziprecruiter_p75_salary", "ziprecruiter_pay_frequencies", "ziprecruiter_salary_histogram", "ziprecruiter_salaries_by_state", "ziprecruiter_top_paying_cities", "ziprecruiter_related_titles", "ziprecruiter_total_listings", "ziprecruiter_spread_level", "ziprecruiter_location_granularity", "ziprecruiter_preferred_pay_period", "ziprecruiter_job_title_searched", "ziprecruiter_salaries_updated_at_text", "ziprecruiter_summary", "ziprecruiter_faq", "ziprecruiter_json_ld_median" ], "properties": { "location": { "type": "string", "nullable": true, "description": "The scope the figures describe: the state or province name on a state request, and the\ncountry name (`United States`, `Canada`) on a national one. The page stating its own\nscope, not an echo of the request.", "example": "United States" }, "job_title": { "type": "string", "nullable": true, "description": "ZipRecruiter's canonical title for the page, which can differ from what was sent:\n`Registered Nurse` resolves to `RN`. What was sent is echoed in `parameters`, and the\npage's own raw title is `ziprecruiter_job_title_searched`.", "example": "RN" }, "min_salary": { "type": "number", "nullable": true, "description": "10th percentile annual pay. The bottom of the middle 80%, not the lowest observed.", "example": 56000 }, "max_salary": { "type": "number", "nullable": true, "description": "90th percentile annual pay. The top of the middle 80%, not the highest observed.", "example": 131000 }, "median_salary": { "type": "number", "nullable": true, "description": "The real annual median, parsed from the page's own data layer. NOT the JSON-LD field\nlabelled `median`, which is the mean and reads up to 13.8% high; that figure is carried\nseparately as `ziprecruiter_json_ld_median`.", "example": 82000 }, "min_base_salary": { "type": "number", "nullable": true, "description": "Always `null`. ZipRecruiter publishes no base-versus-additional-pay split anywhere on\nthis surface, so a base figure would have to be invented. Present so the row width\nnever changes.", "example": null }, "max_base_salary": { "type": "number", "nullable": true, "description": "Always `null`, for the same reason as `min_base_salary`.", "example": null }, "median_base_salary": { "type": "number", "nullable": true, "description": "Always `null`, for the same reason as `min_base_salary`.", "example": null }, "min_additional_pay": { "type": "number", "nullable": true, "description": "Always `null`. ZipRecruiter states total pay only, with no bonus, commission or equity\ncomponent broken out.", "example": null }, "max_additional_pay": { "type": "number", "nullable": true, "description": "Always `null`, for the same reason as `min_additional_pay`.", "example": null }, "median_additional_pay": { "type": "number", "nullable": true, "description": "Always `null`, for the same reason as `min_additional_pay`.", "example": null }, "salary_period": { "type": "string", "enum": [ "HOUR", "WEEK", "MONTH", "YEAR" ], "nullable": true, "description": "Always `YEAR`. ZipRecruiter's own structured data is annual on every page measured,\nincluding titles the page leads with an hourly figure, so annual keeps titles\ncomparable. The other frequencies are in `ziprecruiter_pay_frequencies`.", "example": "YEAR" }, "salary_currency": { "type": "string", "nullable": true, "description": "ISO 4217 currency of every figure on the row, from the page's own country field. `USD`\nfor US pages, `CAD` for Canadian ones.", "example": "USD" }, "salary_count": { "type": "integer", "nullable": true, "description": "Always `null`. ZipRecruiter states no sample size for its estimate. The count of open\npostings behind the page is a different quantity and is published as\n`ziprecruiter_total_listings`.", "example": null }, "salaries_updated_at": { "type": "string", "format": "date-time", "nullable": true, "description": "ISO 8601 UTC timestamp of the date ZipRecruiter last refreshed the figures. The raw\ntext it prints is kept as `ziprecruiter_salaries_updated_at_text`.", "example": "2026-09-12T00:00:00.000Z" }, "publisher_name": { "type": "string", "description": "Always `ZipRecruiter`. Constant by construction on this source.", "example": "ZipRecruiter" }, "publisher_link": { "type": "string", "format": "uri", "nullable": true, "description": "The ZipRecruiter salary page these figures were read from, so any number on the row can\nbe checked against its source.", "example": "https://www.ziprecruiter.com/Salaries/Registered-Nurse-Salary" }, "confidence": { "type": "string", "nullable": true, "description": "Always `null`. ZipRecruiter states no estimator confidence. `ziprecruiter_spread_level`\ndescribes how widely the top-city figures spread, which is a different thing and is\nnever presented as confidence.", "example": null }, "ziprecruiter_average_salary": { "type": "number", "nullable": true, "description": "The annual MEAN. Published under its real name so it is never confused with\n`median_salary`; the two differ on every title measured.", "example": 87868 }, "ziprecruiter_national_average_salary": { "type": "number", "nullable": true, "description": "The national annual mean for this title. Equal to `ziprecruiter_average_salary` on a\nnational request; the benchmark a state figure is above or below on a state request.", "example": 87868 }, "ziprecruiter_p25_salary": { "type": "number", "nullable": true, "description": "25th percentile annual pay. With p75 it gives the interquartile range, which JSearch\ndoes not publish.", "example": 65500 }, "ziprecruiter_p75_salary": { "type": "number", "nullable": true, "description": "75th percentile annual pay.", "example": 104000 }, "ziprecruiter_pay_frequencies": { "type": "object", "nullable": true, "description": "All four pay frequencies in one response, each with its own full distribution. Read\n`hour` for an hourly role without a second request and without dividing an annual\nfigure by an assumed number of hours.", "required": [ "year", "month", "week", "hour" ], "properties": { "year": { "$ref": "#/components/schemas/PayBlock" }, "month": { "$ref": "#/components/schemas/PayBlock" }, "week": { "$ref": "#/components/schemas/PayBlock" }, "hour": { "$ref": "#/components/schemas/PayBlock" } } }, "ziprecruiter_salary_histogram": { "$ref": "#/components/schemas/SalaryHistogram" }, "ziprecruiter_salaries_by_state": { "type": "array", "description": "Pay for this title in every US state and Canadian province ZipRecruiter has figures\nfor, 59 to 64 rows. National requests only: an empty array on a state request, rather\nthan the national table repeated.", "items": { "$ref": "#/components/schemas/StateSalary" } }, "ziprecruiter_top_paying_cities": { "type": "array", "description": "The 10 highest-paying cities for this title, across the country on a national request\nand within the state on a state request.", "items": { "$ref": "#/components/schemas/CitySalary" } }, "ziprecruiter_related_titles": { "type": "array", "description": "The 5 related titles ZipRecruiter lists, each with its pay delta against the searched\ntitle. Every one can be fed straight back into `job_title`.", "items": { "$ref": "#/components/schemas/RelatedTitle" } }, "ziprecruiter_total_listings": { "type": "integer", "nullable": true, "description": "How many open ZipRecruiter postings sit behind this page right now. A demand signal,\nnot a sample size, which is why `salary_count` stays `null`. `0` is a real answer.", "example": 506 }, "ziprecruiter_spread_level": { "type": "string", "nullable": true, "description": "How widely the top-city figures spread: `large`, `medium` or `small`. ZipRecruiter's\nown label. Never an estimator confidence, which this source does not publish.", "example": "large" }, "ziprecruiter_location_granularity": { "type": "string", "enum": [ "NATIONAL", "STATE" ], "nullable": true, "description": "Which page answered: `NATIONAL` or `STATE`. Read from the page's own scope field rather\nthan inferred from the request, so it is the ground truth for what `location` describes.", "example": "NATIONAL" }, "ziprecruiter_preferred_pay_period": { "type": "string", "enum": [ "HOUR", "WEEK", "MONTH", "YEAR" ], "nullable": true, "description": "The frequency ZipRecruiter itself leads the page with: `HOUR` on 6 of 11 titles\nmeasured. Editorial signal about the role, kept out of `salary_period` so titles stay\ncomparable.", "example": "HOUR" }, "ziprecruiter_job_title_searched": { "type": "string", "nullable": true, "description": "The page's own raw title, before ZipRecruiter's canonicalisation. `Registered Nurse`\nwhere `job_title` reads `RN`.", "example": "Registered Nurse" }, "ziprecruiter_salaries_updated_at_text": { "type": "string", "nullable": true, "description": "The refresh date exactly as ZipRecruiter prints it. The parsed form is\n`salaries_updated_at`.", "example": "September 12 2026" }, "ziprecruiter_summary": { "type": "string", "nullable": true, "description": "ZipRecruiter's own prose summary of the figures, HTML stripped to plain text. Ready to\nshow to an end user without writing the sentence yourself.", "example": "The average annual pay for a registered nurse in the United States is $87,868 a year..." }, "ziprecruiter_faq": { "type": "array", "description": "ZipRecruiter's generated FAQ for this title and scope, typically 3 entries covering the\nheadline figure, the best-paying related titles and the top-paying cities. An empty\narray when the page carries none.", "items": { "$ref": "#/components/schemas/SalaryFaqItem" } }, "ziprecruiter_json_ld_median": { "type": "number", "nullable": true, "description": "The figure ZipRecruiter's own JSON-LD labels `median`, carried so the discrepancy is\nauditable. It is the MEAN: byte-identical to the page average on 16 of 16 pages\nmeasured, and on Truck Driver it reads 56,348 against a true median of 49,500, 13.8%\nhigh. Compare it to `median_salary`.", "example": 87868 } } }, "ApplyOption": { "type": "object", "description": "One way to apply to this job. ZipRecruiter exposes exactly one, its own posting page, so\nthis array has either one entry or none.", "required": [ "publisher", "apply_link", "is_direct" ], "properties": { "publisher": { "type": "string", "description": "Always `ZipRecruiter`; every row on this surface is a ZipRecruiter listing.", "example": "ZipRecruiter" }, "apply_link": { "type": "string", "format": "uri", "description": "The canonical ZipRecruiter posting URL, identical to `job_apply_link`.", "example": "https://www.ziprecruiter.com/c/Capital-One/Job/Senior-AI-Engineer-(AI-Foundations)/-in-Manhattan,NY?jid=936215cb503d8be2" }, "is_direct": { "type": "boolean", "description": "Always `false`. The destination is ZipRecruiter itself or an ad network relay, never a\nverified employer ATS.", "example": false } } }, "EmployerReview": { "type": "object", "description": "One employer rating, published by Breakroom. Note the scale: `max_score` is 10, not 5, and\nthe score is carried unchanged rather than renormalised.", "required": [ "publisher", "employer_name", "score", "num_stars", "review_count", "max_score", "reviews_link" ], "properties": { "publisher": { "type": "string", "description": "Who published the rating. `Breakroom` on every sample measured.", "example": "Breakroom" }, "employer_name": { "type": "string", "nullable": true, "description": "The employer the rating is about, as the rating source names it.", "example": "Capital One" }, "score": { "type": "number", "description": "The rating, on the `max_score` scale, rounded to 2 decimals.", "example": 7.76 }, "num_stars": { "type": "integer", "description": "`score` rounded to the nearest whole number, on the same scale as `max_score`.", "example": 8 }, "review_count": { "type": "integer", "nullable": true, "description": "How many responses the rating is based on.", "example": 148 }, "max_score": { "type": "integer", "description": "The top of the scale. `10` for Breakroom, not 5.", "example": 10 }, "reviews_link": { "type": "string", "format": "uri", "nullable": true, "description": "The Breakroom company page the rating comes from.", "example": "https://breakroom.cc/companies/capital-one" } } }, "FaqItem": { "type": "object", "description": "One generated FAQ entry. ZipRecruiter writes these about the ROLE rather than the employer,\nso most answers describe the occupation; a few are Breakroom survey findings about the\nemployer.", "required": [ "question", "answer" ], "properties": { "question": { "type": "string", "nullable": true, "description": "The question, verbatim.", "example": "What skills or qualities help someone succeed as a Senior Software Engineer?" }, "answer": { "type": "string", "nullable": true, "description": "The answer, verbatim. May contain inline HTML where ZipRecruiter published it.", "example": "Key technical skills include expertise in programming languages such as Java, Python, or C++." } } }, "Job": { "type": "object", "description": "A ZipRecruiter job posting. A superset of the 35-key JSearch `/search` contract, whose keys\ncome first in contract order, followed by 25 `ziprecruiter_*` extras, for 60 keys in total.\nEvery key is always present, `null` / `[]` / `{}` where ZipRecruiter has no value, so the\nobject width never changes. The only thing that narrows it is the `fields` projection,\nwhich returns exactly the keys asked for plus `job_id` and `job_title`.\n\nFields marked 'detail surface only' are `null` on a `/search` response unless\n`include_details=true`, and are filled on `/job-details`.", "required": [ "job_id", "job_title", "employer_name", "employer_logo", "employer_website", "job_publisher", "job_employment_type", "job_employment_types", "job_apply_link", "job_apply_is_direct", "apply_options", "job_description", "job_is_remote", "job_posted_at", "job_posted_at_timestamp", "job_posted_at_datetime_utc", "job_location", "job_city", "job_state", "job_country", "job_latitude", "job_longitude", "job_benefits", "job_benefits_strings", "job_google_link", "job_salary", "job_salary_string", "job_min_salary", "job_max_salary", "job_salary_period", "job_highlights", "job_onet_soc", "job_onet_job_zone", "employer_reviews", "job_uid", "ziprecruiter_listing_key", "ziprecruiter_short_description", "ziprecruiter_description_html", "ziprecruiter_share_url", "ziprecruiter_canonical_job_url", "ziprecruiter_updated_at", "ziprecruiter_is_new", "ziprecruiter_apply_type", "ziprecruiter_apply_host", "ziprecruiter_salary_source", "ziprecruiter_salary_is_estimated", "ziprecruiter_location_type", "ziprecruiter_location_county", "ziprecruiter_location_postal_code", "ziprecruiter_location_id", "ziprecruiter_company_id", "ziprecruiter_company_slug", "ziprecruiter_company_size", "ziprecruiter_company_hq", "ziprecruiter_company_industries", "ziprecruiter_job_industry", "ziprecruiter_valid_through", "ziprecruiter_ats_identifier", "ziprecruiter_key_responsibilities", "ziprecruiter_employer_faq" ], "properties": { "job_id": { "type": "string", "description": "Stable, opaque id for this posting. Pass it straight back to `/job-details`. Encodes\nZipRecruiter's own seat id, so it survives re-fetches and is the same on every surface.", "example": "emlwcmVjcnVpdGVyOjkzNjIxNWNiNTAzZDhiZTI" }, "job_title": { "type": "string", "nullable": true, "description": "The job title as ZipRecruiter publishes it. 100% fill.", "example": "Senior AI Engineer (AI Foundations)" }, "employer_name": { "type": "string", "nullable": true, "description": "The hiring company's name. 100% fill.", "example": "Capital One" }, "employer_logo": { "type": "string", "format": "uri", "nullable": true, "description": "The employer's logo. 69% fill from ZipRecruiter itself; the remainder is lifted from\nthe employer's own domain where one is known. Never ZipRecruiter's own favicon.", "example": "https://www.ziprecruiter.com/svc/fotomat/public-nosensitive-ziprecruiter-logos/company/60122984.png" }, "employer_website": { "type": "string", "format": "uri", "nullable": true, "description": "The employer's own website, from ZipRecruiter's company widget. Detail surface only,\n54% fill; a search card carries no company widget at all.", "example": "https://capitalone.com" }, "job_publisher": { "type": "string", "enum": [ "ZipRecruiter" ], "description": "Always `ZipRecruiter`. Constant by construction on this source.", "example": "ZipRecruiter" }, "job_employment_type": { "type": "string", "nullable": true, "enum": [ "FULLTIME", "CONTRACTOR", "PARTTIME", "INTERN", "TEMPORARY", "OTHER", null ], "description": "The first entry of `job_employment_types`, for JSearch compatibility. `null` when\nZipRecruiter states no employment type. JSearch's `PER_DIEM` is never emitted, because\nZipRecruiter has no equivalent. `INTERN` appears here even though it is not an\n`employment_types` filter value: ZipRecruiter labels internships on the posting but\nignores an internship filter on its search, so it is reported and not offered.", "example": "FULLTIME" }, "job_employment_types": { "type": "array", "description": "Every employment type stated on the posting, in JSearch's documented order so two\nidentically tagged jobs always serialise the same way. An empty array when\nZipRecruiter states none, never `null`. `INTERN` is a reported value here but not an\n`employment_types` filter value, because ZipRecruiter ignores an internship filter.", "items": { "type": "string", "enum": [ "FULLTIME", "CONTRACTOR", "PARTTIME", "INTERN", "TEMPORARY", "OTHER" ] }, "example": [ "FULLTIME" ] }, "job_apply_link": { "type": "string", "format": "uri", "nullable": true, "description": "The canonical ZipRecruiter posting URL, with tracking parameters stripped. 100% fill,\nnever expires with an impression token, and really is a page a human can apply from.\nDeliberately not the decoded redirect destination, which is missing on 42% of jobs.", "example": "https://www.ziprecruiter.com/c/Capital-One/Job/Senior-AI-Engineer-(AI-Foundations)/-in-Manhattan,NY?jid=936215cb503d8be2" }, "job_apply_is_direct": { "type": "boolean", "description": "Always `false`. A ZipApply job is applied to on ZipRecruiter, and an external job goes\nthrough a redirect whose destination is an ad network relay more often than an employer\nATS, so a direct-apply claim would be unverifiable either way. See\n`ziprecruiter_apply_type` for the real signal.", "example": false }, "apply_options": { "type": "array", "description": "Ways to apply. ZipRecruiter exposes exactly one, its own posting page, so this is a\none-entry array, or empty on the rare job with no resolvable URL.", "items": { "$ref": "#/components/schemas/ApplyOption" } }, "job_description": { "type": "string", "nullable": true, "description": "The full posting text, HTML stripped to plain text with paragraph breaks preserved.\n**Detail surface only, and this is the field callers most often expect for free:** it\nis `null` on a `/search` response unless `include_details=true`, because a ZipRecruiter\nsearch card carries only a roughly 200-character teaser, published separately as\n`ziprecruiter_short_description`. 100% fill on the detail surface.", "example": "Senior AI Engineer (AI Foundations)\n\nOverview:\n\nAt Capital One, we are creating responsible and reliable AI systems, changing banking for good." }, "job_is_remote": { "type": "boolean", "nullable": true, "description": "Whether the job can be done remotely. A real tri-state here: ZipRecruiter states a\nworkplace type on 100% of postings, so `false` is a supported answer and not a guess.\nFully remote and remote-optional map to `true`; hybrid and in-person map to `false`.", "example": false }, "job_posted_at": { "type": "string", "nullable": true, "description": "Relative publication age, for example `4 days ago` or `1 month ago`. Derived from\nZipRecruiter's own posted-at stamp, not from its JSON-LD `datePosted`, which is a\nreindex stamp and disagrees with reality on 58% of postings.", "example": "4 days ago" }, "job_posted_at_timestamp": { "type": "integer", "nullable": true, "description": "Unix timestamp in seconds of the publication date. 100% fill.", "example": 1788992809 }, "job_posted_at_datetime_utc": { "type": "string", "format": "date-time", "nullable": true, "description": "ISO 8601 UTC form of `job_posted_at_timestamp`.", "example": "2026-09-09T22:26:49.000Z" }, "job_location": { "type": "string", "nullable": true, "description": "The location as ZipRecruiter displays it on the posting. 100% fill.", "example": "Manhattan, NY" }, "job_city": { "type": "string", "nullable": true, "description": "City. `null` on a state-level or remote-only listing, which is why it is read\ndefensively rather than assumed.", "example": "Manhattan" }, "job_state": { "type": "string", "nullable": true, "description": "The full state or province NAME, not the code, matching JSearch. The two-letter code\nappears inside `job_location`.", "example": "New York" }, "job_country": { "type": "string", "nullable": true, "description": "Uppercase ISO 3166-1 alpha-2 country code. `US` or `CA` on this source.", "example": "US" }, "job_latitude": { "type": "number", "format": "float", "nullable": true, "description": "Always `null`. ZipRecruiter publishes no coordinates anywhere: not on the card, not in\nthe detail payload, and not in the JSON-LD. Present so the object width never changes,\nand never invented from the city name.", "example": null }, "job_longitude": { "type": "number", "format": "float", "nullable": true, "description": "Always `null`, for the same reason as `job_latitude`. ZipRecruiter publishes no\ncoordinates on either surface.", "example": null }, "job_benefits": { "type": "array", "nullable": true, "description": "Normalised benefit tags ZipRecruiter states on the posting. 44% fill; `null` rather\nthan an empty array when none are stated.", "items": { "type": "string", "enum": [ "medical", "dental", "vision", "life_insurance", "paid_time_off", "retirement" ] }, "example": [ "medical", "dental", "vision", "paid_time_off", "retirement" ] }, "job_benefits_strings": { "type": "array", "nullable": true, "description": "ZipRecruiter's own benefit labels, split out of its single comma-joined display string.\nSame 44% fill as `job_benefits`; `null` when none are stated.", "items": { "type": "string" }, "example": [ "Medical", "Dental", "Vision", "Life", "Retirement", "PTO" ] }, "job_google_link": { "type": "string", "format": "uri", "nullable": true, "description": "Always `null`. This link is a Google for Jobs construction built around a Google docid,\nand ZipRecruiter has none. Building one around a ZipRecruiter id would produce a URL\nthat resolves to nothing.", "example": null }, "job_salary": { "type": "number", "nullable": true, "description": "The headline salary figure: the midpoint when the posting states a range, the single\nbound otherwise, in the period given by `job_salary_period`. 69% fill. Populated only\nwhen ZipRecruiter itself displays the pay, so it is never its own hidden model\nestimate.", "example": 155750 }, "job_salary_string": { "type": "string", "nullable": true, "description": "ZipRecruiter's own salary text, verbatim, exactly as shown on the page. 69% fill.", "example": "$134K - $177K/yr" }, "job_min_salary": { "type": "number", "nullable": true, "description": "Lower bound of the stated range, in the `job_salary_period` unit. 69% fill.", "example": 134400 }, "job_max_salary": { "type": "number", "nullable": true, "description": "Upper bound of the stated range, in the `job_salary_period` unit. 69% fill.", "example": 177100 }, "job_salary_period": { "type": "string", "nullable": true, "enum": [ "HOUR", "DAY", "WEEK", "MONTH", "YEAR", null ], "description": "The period the salary figures are expressed in. 69% fill.", "example": "YEAR" }, "job_highlights": { "type": "object", "description": "Description bullets grouped by section, keyed `Qualifications`, `Responsibilities` and\n`Benefits`. Recovered from the posting's own headed lists, plus ZipRecruiter's extracted\nkey responsibilities where it provides them. Detail surface only, 72% fill; `{}` and\nnever `null` when nothing was recovered, so it is always safe to enumerate. A heading\nthat matches no section is skipped rather than guessed into a bucket.", "additionalProperties": { "type": "array", "items": { "type": "string" } }, "example": { "Responsibilities": [ "Design, develop, test, deploy, and support AI software components." ], "Qualifications": [ "At least 3 years of experience programming with Python, Go, Scala, or Java" ] } }, "job_onet_soc": { "type": "string", "nullable": true, "description": "The O*NET-SOC occupation code ZipRecruiter states, with the human title removed.\nDetail surface only, and capped at 73% because it comes from JSON-LD, which\nZipRecruiter ships on 73% of detail pages. Never inferred from the title.", "example": "15-1132.00" }, "job_onet_job_zone": { "type": "string", "nullable": true, "description": "Always `null`. The O*NET job zone is a Google enrichment. ZipRecruiter states the SOC\ncode but never the zone, and deriving one would need an O*NET table this API does not\nship.", "example": null }, "employer_reviews": { "type": "array", "nullable": true, "description": "Employer ratings published by Breakroom. Detail surface only, 14% fill; `null` when\nZipRecruiter shows no rating. Note the scale is 1 to 10, carried as `max_score` rather\nthan renormalised to 5.", "items": { "$ref": "#/components/schemas/EmployerReview" } }, "job_uid": { "type": "string", "description": "ZipRecruiter's own raw seat id, 16 hex characters. Stable across surfaces and\nre-fetches, accepted directly by `/job-details`, and the right key for an enrichment\ncache.", "example": "936215cb503d8be2" }, "ziprecruiter_listing_key": { "type": "string", "nullable": true, "description": "ZipRecruiter's internal listing key. Useful for diffing payloads, but NOT an identity:\nthe same job can carry different keys on different surfaces. Use `job_id` or `job_uid`.", "example": "nl4pTJGdpooiHxf1Uq5XRw" }, "ziprecruiter_short_description": { "type": "string", "nullable": true, "description": "The roughly 200-character teaser a card carries instead of a description. Card surface\nonly: always `null` on `/job-details`, where the full `job_description` is present\ninstead. Passed through verbatim, so unlike `job_description` it can carry\nZipRecruiter's own `` search-highlight markup and undecoded HTML entities; strip or\ndecode it before display.", "example": "Senior AI Engineer (AI Foundations) Overview: At Capital One, we are creating responsible and reliable AI systems, changing banking for good." }, "ziprecruiter_description_html": { "type": "string", "nullable": true, "description": "The job description with ZipRecruiter's original HTML markup preserved, for callers who\nwant the formatting. Detail surface only, 100% fill there.", "example": "Senior AI Engineer (AI Foundations)
Overview:
At Capital One, we are creating responsible ...
" }, "ziprecruiter_share_url": { "type": "string", "format": "uri", "nullable": true, "description": "ZipRecruiter's own short share link for the posting.", "example": "https://www.ziprecruiter.com/job-redirect/share?match_token=CqABChZubDRwVEpHZHBvb2lIeGYxVXE1WFJ3" }, "ziprecruiter_canonical_job_url": { "type": "string", "format": "uri", "nullable": true, "description": "The canonical ZipRecruiter posting URL. Identical to `job_apply_link`, exposed under\nits own name so a caller reading the ZipRecruiter extras does not have to reach into\nthe JSearch contract keys.", "example": "https://www.ziprecruiter.com/c/Capital-One/Job/Senior-AI-Engineer-(AI-Foundations)/-in-Manhattan,NY?jid=936215cb503d8be2" }, "ziprecruiter_updated_at": { "type": "string", "nullable": true, "description": "When ZipRecruiter last refreshed the listing, distinct from the publication date. Search\nsurface only: `null` on `/job-details`. Nanosecond precision, as ZipRecruiter publishes\nit.", "example": "2026-09-14T04:20:33.688364560Z" }, "ziprecruiter_is_new": { "type": "boolean", "nullable": true, "description": "ZipRecruiter's own 'new' badge on a search card. Search surface only, and `null` rather\nthan `false` when the badge is simply absent from the payload.", "example": null }, "ziprecruiter_apply_type": { "type": "string", "nullable": true, "enum": [ "OPEN_APPLY_FLOW", "OPEN_EXTERNAL", null ], "description": "How applying works. `OPEN_APPLY_FLOW` is ZipApply, applied on ZipRecruiter itself;\n`OPEN_EXTERNAL` leaves for a third-party destination. This is the honest apply signal,\nsince `job_apply_is_direct` cannot be verified.", "example": "OPEN_EXTERNAL" }, "ziprecruiter_apply_host": { "type": "string", "nullable": true, "description": "The hostname behind ZipRecruiter's external apply redirect, decoded. Provenance only:\nit is frequently an ad network relay rather than the employer's ATS, which is exactly\nwhy it is not used as the apply link.", "example": "dsp.prng.co" }, "ziprecruiter_salary_source": { "type": "string", "nullable": true, "enum": [ "SOURCE_PROVIDED", "SOURCE_PARSED", "SOURCE_PREDICTED", "SOURCE_MISSING", null ], "description": "Where ZipRecruiter's pay figure came from. Always published, even when the salary\nfields are `null`, so a caller can see WHY a job has no salary: `SOURCE_MISSING` means\nthe employer stated no pay at all and ZipRecruiter modelled and then hid a figure,\nwhich this API suppresses rather than passes off as the employer's.", "example": "SOURCE_PREDICTED" }, "ziprecruiter_salary_is_estimated": { "type": "boolean", "nullable": true, "description": "Whether ZipRecruiter labels the displayed pay as an estimate. `null` when there is no\ndisplayed pay to label, which is different from a pay figure explicitly marked as\nstated.", "example": true }, "ziprecruiter_location_type": { "type": "string", "nullable": true, "enum": [ "LOCATION_TYPE_NAME_IN_PERSON", "LOCATION_TYPE_NAME_REMOTE", "LOCATION_TYPE_NAME_REMOTE_OPTIONAL", "LOCATION_TYPE_NAME_HYBRID", null ], "description": "ZipRecruiter's own workplace-type enum, passed through verbatim. 100% fill, and the\nsource `job_is_remote` is derived from.", "example": "LOCATION_TYPE_NAME_IN_PERSON" }, "ziprecruiter_location_county": { "type": "string", "nullable": true, "description": "County or equivalent administrative area for the job location.", "example": "New York" }, "ziprecruiter_location_postal_code": { "type": "string", "nullable": true, "description": "Postal or ZIP code, as a string so leading zeros survive.", "example": "10012" }, "ziprecruiter_location_id": { "type": "string", "nullable": true, "description": "ZipRecruiter's internal identifier for the location.", "example": "0a070499-f1f0-42d9-940e-76c39915e34a" }, "ziprecruiter_company_id": { "type": "string", "nullable": true, "description": "ZipRecruiter's internal company identifier, an opaque base64 blob rather than a number,\nstringified like every other id in this response.", "example": "LvOba8F2oEpGlw2IxG/RnmjRZMM=" }, "ziprecruiter_company_slug": { "type": "string", "nullable": true, "description": "ZipRecruiter's canonical display name for the company. A display label only: scoping a\nsearch to this employer is done with `ziprecruiter_company_id`, not with this name.", "example": "capital one" }, "ziprecruiter_company_size": { "type": "string", "nullable": true, "description": "Employee headcount band from ZipRecruiter's company widget, for example\n`1001 - 5000 Employees`. Detail surface only, 54% fill.", "example": "10000+ Employees" }, "ziprecruiter_company_hq": { "type": "string", "nullable": true, "description": "The company's headquarters location from ZipRecruiter's company widget. Detail surface\nonly, 54% fill.", "example": "McLean, VA, US" }, "ziprecruiter_company_industries": { "type": "array", "nullable": true, "description": "Industries ZipRecruiter assigns to the COMPANY, distinct from the job's own industry.\nDetail surface only; `null` when the widget lists none.", "items": { "type": "string" }, "example": [ "Funds, Trusts and Financial Programs", "Real Estate" ] }, "ziprecruiter_job_industry": { "type": "string", "nullable": true, "description": "The industry ZipRecruiter assigns to this JOB. From JSON-LD, so detail surface only and\ncapped at 73%.", "example": "Technology" }, "ziprecruiter_valid_through": { "type": "string", "nullable": true, "description": "The date the posting expires, as ZipRecruiter states it in JSON-LD. Detail surface\nonly, capped at 73%.", "example": "2026-10-14" }, "ziprecruiter_ats_identifier": { "type": "string", "nullable": true, "description": "The employer's own requisition reference, from the posting's JSON-LD identifier. Detail\nsurface only, and present on 40 of the 43 measured pages that carry JSON-LD at all.", "example": "R1000242" }, "ziprecruiter_key_responsibilities": { "type": "array", "nullable": true, "description": "ZipRecruiter's machine-extracted responsibility summaries. These are rewritten\nsummaries, not verbatim description bullets. Detail surface only, present on roughly a\nthird of detail pages; also merged into `job_highlights.Responsibilities`.", "items": { "type": "string" }, "example": null }, "ziprecruiter_employer_faq": { "type": "array", "nullable": true, "description": "ZipRecruiter's generated FAQ for the posting. Detail surface only. Despite the contract\nname, most entries are about the ROLE rather than the employer; some are Breakroom\nsurvey findings about the employer.", "items": { "$ref": "#/components/schemas/FaqItem" } } } } } } }