Skip to content
Backspin

Search jobs

GET /v1/jobs

Returns {"jobs": [Job…], "next_cursor": "…" | null}, newest first (by when Backspin first saw the job). Pages are stable: a job open for your whole walk appears exactly once. Jobs added while you page show up in the changes feed.

Closed jobs never appear here, and neither do jobs from boards that are disabled or haven’t crawled successfully for 14 days.

Filters

Section titled “Filters”

Every parameter, with its allowed values, is in the API reference. All are optional and combine with AND. A few work in ways worth knowing:

  • category, exclude and pay_period can be repeated. Repeated category or pay_period values match any of them; repeated exclude values leave out each one.
  • country and region match any of the job’s locations. Given both, they must match the same location.
  • q matches jobs whose title or company name contains every word, up to 10 words.
  • posted_since counts a job with no stated posting date from when Backspin first saw it.
  • Pay filters look at the job’s own pay, from the employer’s pay field or read from the description (pay_from picks one). Jobs without pay never match pay_period, pay_currency or pay_at_least, but stay in when you exclude=hourly_pay.
  • pay_at_least compares the top of the range (max, else min) in the job’s own period and currency, so it needs exactly one pay_period and a pay_currency. Backspin never converts hourly to yearly.
  • fields=summary sets description_html to null for a much smaller answer.
  • limit is 1 to 500, 100 by default. Pass next_cursor as cursor for the next page.

An unknown, repeated (other than category, exclude and pay_period), empty or invalid parameter is a 422 that names it, so a typo never widens your query.

Examples

Section titled “Examples”

Electrician jobs with pay:

GET /v1/jobs?category=electrical&country=US&has_pay=true

Account executive jobs with a base salary of at least $100,000 and no commission-only, door-to-door or retail sales:

GET /v1/jobs?category=account_executive&country=US&pay_period=year&pay_currency=USD&pay_at_least=100000&exclude=commission_only&exclude=door_to_door&exclude=retail_sales