Skip to main content
GET /v1/jobs and GET /v1/companies return one page at a time, with a next cursor.

Read every page

  1. Send your request without cursor.
  2. If next is not null, send the same request again with cursor set to next.
  3. Stop when next is null.

Good to know

  • Keep every other param the same while you page. Only cursor changes.
  • A cursor is not a page number. Do not build or change one; send it back as you got it. A cursor we did not make gets 400.
  • Cursors keep working when new jobs arrive: with sort=newest, new jobs go before your first page, so you never see a job twice in one pass.
  • A job that closes while you page leaves the results. The pages after it do not shift, so you skip no job.
  • Only the last page can have fewer jobs than limit. Still, stop on next being null, not on a short page.
To keep a copy in sync without reading every page again, use the change feed: new, changed and closed jobs in order.