API Reference
Filter Reference Every filter accepted by POST /v1/jobs/search.
All filters are optional fields in the JSON request body of POST /v1/jobs/searchAND . Array filters ending in _or match any of their values; those ending in _not exclude their values.
Field Type Description limitnumberMax results to return. Capped by your plan's page size (Free 25 / Builder 100 / Scale 500). offsetnumberNumber of results to skip (offset pagination). pagenumberPage index (alternative to offset). cursorstringOpaque cursor for the next page, from metadata.next_cursor. order_byobject[]Sort order, e.g. [{ "field": "date_posted", "desc": true }]. include_total_resultsbooleanInclude the total match count in metadata.total_results (otherwise null).
See pagination for how these interact.
Field Type Description job_title_orstring[]Match jobs whose title contains any of these. job_title_notstring[]Exclude jobs whose title contains any of these.
Field Type Description job_country_code_orstring[]Match any of these ISO country codes, e.g. ["US","GB"]. job_country_code_notstring[]Exclude these ISO country codes. remotebooleantrue for remote-only, false to exclude remote.
Field Type Description posted_at_max_age_daysnumberOnly postings newer than this many days. posted_at_gtestringOnly postings on or after this date (YYYY-MM-DD). posted_at_ltestringOnly postings on or before this date (YYYY-MM-DD).
Field Type Description company_name_orstring[]Match any of these company names (exact). company_name_partial_match_orstring[]Match any of these company names (partial / contains).
Field Type Description job_seniority_orstring[]Match any of these seniority levels, e.g. ["Senior"].
Field Type Description job_id_orstring[]Return jobs matching any of these IDs. job_idsstring[]Look up a specific set of job IDs.
The request schema is permissive: unknown fields are passed through to the search backend rather than rejected. The fields above are the supported, stable filters - prefer them for production use.