datasets_jobs_search
Search live job postings from ATS boards and company career sites. Filter by keyword, location, salary, provider, remote, and employment type. Returns structured open-role data.
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.
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 |