JOA — Job Opportunities API

{'type': 'object', 'required': ['since'], 'properties': {'limit': {'type': 'integer', 'description': 'Max events per page, 1-5000 (default 500).'}, 'since': {'type': 'string', 'description': 'RFC3339 timestamp, or the next_since cursor from a previous call.'}, 'event_type': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Only return these change kinds: created, updated, withdrawn, delisted. Filtered CLIENT-SIDE after the call (the underlying feed has no server-side filter for this), so the metered row count for this call is unaffected by this filter.'}}}

{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "Company slug, from search_jobs's company_slug field or /v1/companies."}, 'jobs_limit': {'type': 'integer', 'description': 'Max job rows to include when include_open_jobs is true, 1-50 (default 10).'}, 'history_days': {'enum': [30, 90, 365], 'type': 'integer', 'description': 'Window for the keyless open-roles trend.'}, 'include_open_jobs': {'type': 'boolean', 'description': "Also list this employer's currently live job rows (needs a key)."}}}

{'type': 'object', 'properties': {'include_countries': {'type': 'boolean', 'description': 'Also include the full per-country coverage breakdown.'}, 'include_employers': {'type': 'boolean', 'description': 'Also include the top-500-employer coverage audit table.'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': "The job's id (uuid) or public slug, from search_jobs's id/slug fields."}, 'quality': {'enum': ['all'], 'type': 'string', 'description': 'Pass "all" to re-admit a gated row (see search_jobs).'}, 'include_closed': {'type': 'boolean', 'description': 'Also resolve closed/delisted roles, tagged status="closed".'}, 'include_poster_type': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Re-admit a staffing/jobboard-posted row (see search_jobs).'}}}

{'type': 'object', 'properties': {'country': {'type': 'string', 'description': 'Single ISO 3166-1 alpha-2 country code.'}, 'seniority': {'type': 'string', 'description': 'Single seniority value.'}, 'role_family': {'type': 'string', 'description': 'Single job family/category value -- see the coverage tool for the live vocabulary.'}, 'history_days': {'enum': [30, 90, 365], 'type': 'integer', 'description': 'Window for the history series.'}, 'include_history': {'type': 'boolean', 'description': 'Also return the daily BETA history series for this exact segment.'}}}

{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'General free-text search across title and company name.'}, 'city': {'type': 'array', 'items': {'type': 'string'}, 'description': 'City names, case-insensitive.'}, 'limit': {'type': 'integer', 'description': 'Rows per page, 1-200 (default 25).'}, 'state': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Two-letter US state codes, e.g. OH, TX. US listings only.'}, 'title': {'type': 'string', 'description': 'Free-text match against the job title.'}, 'cursor': {'type': 'string', 'description': "Opaque pagination cursor from a previous response's next_cursor."}, 'remote': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Remote-type facet values: remote, hybrid, on_site, or not_stated.'}, 'status': {'enum': ['live', 'closed', 'any'], 'type': 'string', 'description': 'Which half of the ledger to read. "closed" and "any" need a key.'}, 'company': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these employer slugs -- see company_hiring or /v1/companies.'}, 'country': {'type': 'array', 'items': {'type': 'string'}, 'description': 'ISO 3166-1 alpha-2 country codes, e.g. DE, FR.'}, 'quality': {'enum': ['all'], 'type': 'string', 'description': 'Pass "all" to re-admit a row this API has GATED for reversible doubt (never one it has removed).'}, 'category': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Job family/category facet values -- see the coverage tool or /public/facets for the live vocabulary.'}, 'provider': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these ATS/source providers -- see /public/providers for the live list.'}, 'seniority': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Seniority facet values, e.g. senior, lead.'}, 'has_salary': {'type': 'boolean', 'description': 'Only rows carrying a stated salary.'}, 'max_salary': {'type': 'number', 'description': 'Maximum annualised EUR salary.'}, 'min_salary': {'type': 'number', 'description': 'Minimum annualised EUR salary.'}, 'source_type': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Row-level provenance class: ats, career_site, public_agency, aggregator, or agency.'}, 'posted_after': {'type': 'string', 'description': 'RFC3339 timestamp; only rows posted after this.'}, 'title_exclude': {'type': 'string', 'description': 'Exclude rows whose title matches this text.'}, 'company_domain': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to employers whose verified domain matches.'}, 'require_fields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Only rows where every named field is non-null.'}, 'verified_after': {'type': 'string', 'description': 'RFC3339 timestamp; only rows last re-confirmed live after this.'}, 'employment_type': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Employment-type facet values, e.g. full_time, contract.'}, 'has_description': {'type': 'boolean', 'description': 'Only rows carrying advert text at all.'}, 'exclude_category': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Category values to exclude.'}, 'exclude_provider': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exclude these providers.'}, 'remote_confirmed': {'type': 'boolean', 'description': 'Only rows where remote status is explicitly stated by the employer, never inferred.'}, 'exclude_source_type': {'type': 'array', 'items': {'type': 'string'}, 'description': 'source_type values to exclude.'}, 'include_description': {'type': 'boolean', 'description': 'Include the full advert text (averages 2.5 KB/row; caps limit at 50 when true).'}, 'include_poster_type': {'type': 'array', 'items': {'type': 'string'}, 'description': "Re-admit staffing/jobboard-posted rows: staffing, jobboard, or all. Excluded by default -- this API's default promise is employer-direct."}, 'description_contains': {'type': 'string', 'description': 'Only rows whose full advert text contains this text, case-insensitive.'}, 'exclude_company_domain': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exclude these employer domains.'}}}