search_jobs
Search live, normalized job postings across 30+ sources by title, skill/tech, country, remote, seniority, employment type and recency. Returns real matching postings -- title, company, domain, location, salary range, tech stack and apply URL -- capped at 3 rows per call on this no-key server, with the total match count and the REST call that returns the rest.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return. | |
| remote | No | Only remote roles when true. | |
| city_or | No | Whole city names, e.g. London, Munich. Case-insensitive; a metro wrapper on the stored value is ignored. Spellings and diacritics are normalised for cities we know (München finds Munich, Cracow finds Kraków); other cities match the stored value exactly. | |
| region_or | No | US states and Canadian provinces as ISO 3166-2 codes, e.g. US-NY, CA-ON. Matches every spelling a job board publishes, so CA-ON finds both ON and Ontario. More precise than job_location_or for a state or province. | |
| skills_or | No | Match jobs tagged with any of these skill slugs, e.g. python, kubernetes. | |
| benefits_or | No | Match jobs advertising any of these benefit slugs, e.g. 401k, health insurance. Coverage is partial. | |
| language_or | No | Languages the posting is written in, as lowercase ISO 639-1 codes, e.g. ["en"]. The language of the posting text, not the country: 18.3% of Swedish postings and 17.7% of German ones are in English. Unlabelled postings never match. | |
| job_title_or | Yes | Match any of these job titles. | |
| language_not | No | Exclude postings written in these languages, as lowercase ISO 639-1 codes, e.g. ["fr"]. Unlabelled postings are kept. | |
| metro_code_or | No | Match any of these US CBSA metro codes, e.g. 35620 for New York. Non-US jobs never match. | |
| description_or | No | Match any of these skills or technologies in the posting. | |
| min_salary_usd | No | Only jobs whose posted salary reaches this annual USD amount. Jobs without a posted salary never match; estimated salaries are not consulted. | |
| job_location_or | No | Match any of these cities or regions, e.g. Seattle, WA. Metro wrappers are stripped (Greater London also matches London) and a state, province or UK nation by name matches every spelling of it (Pennsylvania also matches PA). Terms of three characters or fewer are codes or exact names and match whole values (WA is Washington state, never Iowa); a country code or name matches the whole country. For a city by name, city_or is the precise filter. | |
| max_ghost_score | No | Exclude jobs whose ghost-likelihood score (0-100) exceeds this. Unscored jobs always pass. | |
| esco_skill_id_or | No | Match jobs tagged with any of these ESCO skill concept IDs (exact match). | |
| isic_division_or | No | ISIC Rev.4 employer industry divisions (2-digit, e.g. 62). | |
| job_seniority_or | No | Match any of these seniority levels. | |
| employment_type_or | No | Match any of these employment types. | |
| occupation_code_or | No | ISCO-08 occupation codes; 4-digit exact, 1-3 digit as hierarchy prefix. | |
| has_recruiter_email | No | true for only jobs with a recruiter contact email parsed from the posting, false for only jobs without one. | |
| job_country_code_or | No | Match any of these ISO 3166-1 alpha-2 country codes. | |
| max_applicant_count | No | Only jobs with at most this many applicants. Counts exist only where the source exposes them (LinkedIn), so this also drops every job without a count. | |
| visa_sponsorship_or | No | Match any of these visa stances parsed from the posting text: offers, no, citizenship_required. Jobs that say nothing never match. | |
| work_arrangement_or | No | Match any of remote, hybrid or onsite. Finer than remote, which answers false for hybrid and onsite alike. Jobs whose arrangement is unknown never match, and coverage is still backfilling, so this returns far fewer results than expected today; remote is the reliable filter for now. | |
| posted_at_max_age_days | No | Only postings published within this many days. | |
| include_unlabeled_employment_type | No | Also return jobs whose employment type is unknown. About 27% of postings do not state one, and employment_type_or excludes every one of them by default. |