Skip to main content
GET /v1/jobs returns open jobs that match every filter you send.

How filters combine

  • Different filters must all match. country=GB&workplaceType=hybrid keeps hybrid jobs in the UK.
  • A filter you repeat matches any of its values. country=GB&country=IE keeps jobs in the UK or Ireland.
  • A job in several places matches when any of its places matches.
  • Filter values come from the jobs, not from a fixed list. Ask GET /v1/facets which values exist.
q looks in the title, the company name and the department.
  • It finds any part of a word, in any case: q=account finds “Accountant” and “Key Account Manager”.
  • Every word must match: q=senior nurse needs both words.
  • It works in any language and script.
  • It does not search the full job text.

All filters

Notes on some filters:
  • country takes ISO 3166-1 alpha-2 codes such as US, DE or IN.
  • region and city take the names exactly as GET /v1/facets lists them.
  • occupation takes ISCO-08 codes. A short code matches the whole group: 2 is all professionals, 22 is health professionals, 2221 is nursing professionals.
  • salaryMinEur compares yearly pay in euros, so you can compare jobs paid in any currency or per hour. Jobs that publish no pay are left out when you use it.
  • postedAfter takes a date (2026-11-01) or a date and time with a time zone.
  • ids (up to 100) and url (up to 10) look up jobs you already know. url matches the job’s board URL or its application form URL, exactly.
  • benefit and visaSponsorship match fields read from the job text. visaSponsorship leaves out jobs whose text says nothing about visas.
  • A param the API does not know (a typo, or a filter that is gone) is an error, 400, so a search never runs without the filter you meant.

Sort

sort=newest (the default) or sort=oldest, by the date the employer posted the job. When the employer gives no date, or we saw the job before that date, the date we first saw it counts.

One job

GET /v1/jobs/{id} returns one open job. A closed job returns 404.

Full text

Jobs come with a short snippet. If we turned on full text for your account, add fullText=true to GET /v1/jobs, GET /v1/jobs/{id} or GET /v1/changes: each job then also has description, its full text. Other accounts get 403. Ask us to turn it on.

Companies

GET /v1/companies lists companies that have open jobs, with their board and number of open jobs. Filter by part of the name with q and by ats. Use a company’s name in the company filter of GET /v1/jobs.

Freshness

We read each employer’s board about once a day; boards with no new job for a week, every two days. A new job is in the API as soon as we read its board. Answers are cached for up to 10 minutes, so the same request in that time returns the same answer. A job stays in the API while its board lists it, up to 183 days after it was posted (or first seen). A job its board no longer lists leaves the results, usually at the next read of that board. How fast each ATS reaches the API: measured freshness.