Raw schema
{
"type": "object",
"properties": {
"agency": {
"description": "Agency flag: direct, agency, umbrella, or unknown.",
"items": {
"type": "string"
},
"type": "array"
},
"category": {
"description": "Job family/category facet values. Valid: Healthcare, Engineering, Operations & Admin, Sales, uncategorised, Skilled Technician, Retail, Hospitality, Finance, Logistics & Transport, Customer Support, Marketing, Education, Manufacturing, HR & Recruiting, Data & Analytics, Consulting & Strategy, Construction & Trades, Legal & Compliance, Design, Product, Science & Research, Security, Procurement, Safety & Environment. This is a fixed list -- for free-text search use q.",
"items": {
"type": "string"
},
"type": "array"
},
"city": {
"description": "City names, case-insensitive.",
"items": {
"type": "string"
},
"type": "array"
},
"company": {
"description": "Restrict to these employer slugs -- see company_hiring or /v1/companies.",
"items": {
"type": "string"
},
"type": "array"
},
"company_domain": {
"description": "Restrict to employers whose verified domain matches.",
"items": {
"type": "string"
},
"type": "array"
},
"contract_category": {
"description": "Contract kind the posting STATES: permanent, fixed_term, project_based, seasonal, apprenticeship, internship, other, or unknown. permanent returns only postings that state permanence.",
"items": {
"type": "string"
},
"type": "array"
},
"country": {
"description": "ISO 3166-1 alpha-2 country codes, e.g. DE, FR.",
"items": {
"type": "string"
},
"type": "array"
},
"cursor": {
"description": "Opaque pagination cursor from a previous response's next_cursor.",
"type": "string"
},
"description_contains": {
"description": "Only rows whose full advert text contains this text, case-insensitive. Extended syntax as q: quoted phrases, prefix* (or any bare word of 5+ letters), OR, -word exclusions.",
"type": "string"
},
"description_max_chars": {
"description": "Per-row description length in characters when include_description is true (200-100000, default 4000). Long adverts run to 20,000-100,000 characters, i.e. 5,000-25,000 tokens each.",
"type": "integer"
},
"employment_type": {
"description": "Employment-type facet values. Valid: Full-time, Part-time, Contract, Internship, Temporary, not_stated.",
"items": {
"type": "string"
},
"type": "array"
},
"engagement": {
"description": "Employment relationship the posting STATES: employee, vendor, other, or unknown (not established -- most rows). Matches any element of the row's engagement array.",
"items": {
"type": "string"
},
"type": "array"
},
"exclude_category": {
"description": "Category values to exclude.",
"items": {
"type": "string"
},
"type": "array"
},
"exclude_company_domain": {
"description": "Exclude these employer domains.",
"items": {
"type": "string"
},
"type": "array"
},
"exclude_provider": {
"description": "Exclude these providers.",
"items": {
"type": "string"
},
"type": "array"
},
"exclude_source_type": {
"description": "source_type values to exclude.",
"items": {
"type": "string"
},
"type": "array"
},
"has_description": {
"description": "Only rows carrying advert text at all.",
"type": "boolean"
},
"has_salary": {
"description": "Only rows carrying a stated salary.",
"type": "boolean"
},
"include_description": {
"description": "Include the advert text (caps limit at 50 when true). Each row carries a preview of up to description_max_chars characters (default 4000, roughly a thousand tokens); a cut row says so (description_truncated, description_total_chars). get_job always returns the full text.",
"type": "boolean"
},
"include_poster_type": {
"description": "Re-admit staffing/jobboard-posted rows: staffing, jobboard, or all. Excluded by default -- this API's default promise is employer-direct.",
"items": {
"type": "string"
},
"type": "array"
},
"include_total": {
"description": "Add total_estimate to the response: an exact count of the matching rows up to 10,000, page-independent. Costs one extra bounded query.",
"type": "boolean"
},
"limit": {
"description": "Rows per page, 1-200 (default 25).",
"type": "integer"
},
"max_salary": {
"description": "Maximum annualised EUR salary.",
"type": "number"
},
"min_salary": {
"description": "Minimum annualised EUR salary.",
"type": "number"
},
"posted_after": {
"description": "RFC3339 timestamp; only rows posted after this.",
"type": "string"
},
"provider": {
"description": "Restrict to these ATS/source providers -- see /public/providers for the live list.",
"items": {
"type": "string"
},
"type": "array"
},
"q": {
"description": "Full-text across title, company name and location - NOT the advert body (use description_contains for that). Terms are ANDed; a plain term matches whole words only. Extended syntax: quoted phrases, trailing-* prefix, OR, -exclusion. Broad phrases are expensive - pair them with a country or category. Extended syntax: \"exact phrase\", trailing-* prefix (entwickler* also finds entwicklerin and entwickler/in), a OR b, -exclusion; plain queries match whole words exactly. q is free-text search; for a fixed job-family list use category, not q.",
"type": "string"
},
"quality": {
"description": "Pass \"all\" to re-admit a row this API has GATED for reversible doubt (never one it has removed).",
"enum": [
"all"
],
"type": "string"
},
"remote": {
"description": "Remote-type facet values. Valid: remote, hybrid, on_site, not_stated.",
"items": {
"type": "string"
},
"type": "array"
},
"remote_confirmed": {
"description": "Only rows where remote status is explicitly stated by the employer, never inferred.",
"type": "boolean"
},
"require_fields": {
"description": "Only rows where every named field is non-null.",
"items": {
"type": "string"
},
"type": "array"
},
"seniority": {
"description": "Seniority facet values. Valid: Intern, Entry, Mid, Senior, Lead, Manager, Executive, Director, not_stated.",
"items": {
"type": "string"
},
"type": "array"
},
"sort": {
"description": "Set to 'relevance' to order by match quality instead of recency (band-weighted: title, category, company, location; tolerant of equivalents and abbreviations). Requires q and an API key; q under 200 bytes. Rows then carry relevance {score, tier}; scores are ordering-only, never comparable across queries. Deployment-gated: ignored until the ranked mode is enabled.",
"type": "string"
},
"source_type": {
"description": "Row-level provenance class. Valid: ats, career_site, public_agency, aggregator, agency.",
"items": {
"type": "string"
},
"type": "array"
},
"state": {
"description": "Two-letter US state codes, e.g. OH, TX. US listings only.",
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"description": "Which half of the ledger to read. \"closed\" and \"any\" need a key.",
"enum": [
"live",
"closed",
"any"
],
"type": "string"
},
"title": {
"description": "Free-text match against the job title.",
"type": "string"
},
"title_exclude": {
"description": "Exclude rows whose title matches this text. Extended syntax as q: quoted phrases, prefix* (or any bare word of 5+ letters), OR, -word exclusions.",
"type": "string"
},
"verified_after": {
"description": "RFC3339 timestamp; only rows last re-confirmed live after this.",
"type": "string"
},
"working_schedule": {
"description": "Stated schedule: full_time, part_time, flexible, or unknown.",
"items": {
"type": "string"
},
"type": "array"
}
}
}