Raw schema
{
"type": "object",
"properties": {
"job_title_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "Match any of these job titles."
},
"description_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "Match any of these skills or technologies in the posting."
},
"job_country_code_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "Match any of these ISO 3166-1 alpha-2 country codes."
},
"job_location_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "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."
},
"city_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "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": {
"type": "array",
"items": {
"type": "string"
},
"description": "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."
},
"remote": {
"type": "boolean",
"description": "Only remote roles when true."
},
"work_arrangement_or": {
"type": "array",
"items": {
"type": "string",
"enum": [
"remote",
"hybrid",
"onsite"
]
},
"description": "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."
},
"job_seniority_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "Match any of these seniority levels."
},
"skills_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "Match jobs tagged with any of these skill slugs, e.g. python, kubernetes."
},
"occupation_code_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISCO-08 occupation codes; 4-digit exact, 1-3 digit as hierarchy prefix."
},
"isic_division_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISIC Rev.4 employer industry divisions (2-digit, e.g. 62)."
},
"employment_type_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "Match any of these employment types."
},
"language_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "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."
},
"language_not": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exclude postings written in these languages, as lowercase ISO 639-1 codes, e.g. [\"fr\"]. Unlabelled postings are kept."
},
"include_unlabeled_employment_type": {
"type": "boolean",
"description": "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."
},
"visa_sponsorship_or": {
"type": "array",
"items": {
"type": "string",
"enum": [
"offers",
"no",
"citizenship_required"
]
},
"description": "Match any of these visa stances parsed from the posting text: offers, no, citizenship_required. Jobs that say nothing never match."
},
"benefits_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "Match jobs advertising any of these benefit slugs, e.g. 401k, health insurance. Coverage is partial."
},
"metro_code_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "Match any of these US CBSA metro codes, e.g. 35620 for New York. Non-US jobs never match."
},
"max_applicant_count": {
"type": "number",
"description": "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."
},
"has_recruiter_email": {
"type": "boolean",
"description": "true for only jobs with a recruiter contact email parsed from the posting, false for only jobs without one."
},
"min_salary_usd": {
"type": "number",
"description": "Only jobs whose posted salary reaches this annual USD amount. Jobs without a posted salary never match; estimated salaries are not consulted."
},
"max_ghost_score": {
"type": "number",
"description": "Exclude jobs whose ghost-likelihood score (0-100) exceeds this. Unscored jobs always pass."
},
"esco_skill_id_or": {
"type": "array",
"items": {
"type": "string"
},
"description": "Match jobs tagged with any of these ESCO skill concept IDs (exact match)."
},
"posted_at_max_age_days": {
"type": "number",
"description": "Only postings published within this many days."
},
"limit": {
"type": "number",
"description": "Maximum rows to return."
}
},
"required": [
"job_title_or"
],
"additionalProperties": false
}