datasets_jobs_search
Search the jobs dataset (all companies' live postings). Full-text + faceted search over every job posting crawled from every discovered company ATS board (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable, Recruitee, Rippling…
Instructions
Search the jobs dataset (all companies' live postings). Full-text + faceted search over every job posting crawled from every discovered company ATS board (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable, Recruitee, Rippling, Personio, Teamtailor, Oracle, UKG, iCIMS, Eightfold, Gem, Pinpoint) plus 5 single-company big-tech careers platforms (Amazon, Apple, Google, Meta, Tesla). Open roles only by default (set include_closed=true for historical/filled roles). Salary is parsed from a structured field when the provider has one, or from an explicit pay figure stated in the description otherwise, so coverage varies by posting rather than by provider; min_salary/max_salary filter on it and require salary_currency, since comparing raw compensation numbers across currencies is meaningless. Location is also exposed as structured city/state/country fields alongside the free-text location string, so city/state/country filter on an exact match of those parsed components rather than substring-matching the display string. job_family is an exact level-2 ISCO family label assigned from ESCO occupation evidence; ambiguous postings remain unclassified and do not match that filter. employment_type is never populated for google-jobs/meta-jobs, and posted_at (so sort=posted_desc) is never populated for meta-jobs/tesla-jobs -- their upstream APIs expose no such field. provider enum: greenhouse, lever, ashby, workday, smartrecruiters, workable, recruitee, rippling, personio, teamtailor, oracle, ukg, icims, eightfold, gem, pinpoint, amazon-jobs, apple-jobs, google-jobs, meta-jobs, tesla-jobs. workplace_type enum: onsite, hybrid, remote. sort enum: relevance, posted_desc, company_asc. Billing: this search costs 1 credit per 10 records returned, rounded up, with a minimum of 1 (up to 10 records cost 1, a full page of 100 costs 10).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text over title, company, description | |
| city | No | Exact city filter (parsed location component) | |
| page | No | Page number, default 1 | |
| sort | No | Sort enum: relevance, posted_desc, company_asc | |
| state | No | Exact state/region filter (parsed location component) | |
| remote | No | Filter by remote (true or false) | |
| company | No | Company name match | |
| country | No | Exact country filter (parsed location component); ISO country code or name, matched case-insensitively | |
| location | No | Location match | |
| provider | No | Provider filter | |
| page_size | No | Page size, default 20, max 100; page*page_size must be <= 10000 | |
| department | No | Exact department filter | |
| job_family | No | Exact ESCO/ISCO job-family label filter | |
| max_salary | No | Maximum salary (matches postings whose range starts at or below this); requires salary_currency | |
| min_salary | No | Minimum salary (matches postings whose range reaches at least this); requires salary_currency | |
| include_closed | No | Include closed/filled roles (default false = open only) | |
| workplace_type | No | Workplace type filter | |
| employment_type | No | Exact employment-type filter | |
| salary_currency | No | 3-letter ISO currency code (e.g. USD) the min_salary/max_salary bounds are in; required when either bound is set |