Skip to main content

1. Create an API key

Sign up free ($5 free starting balance, no credit card required) or sign in to the dashboard. Open Developers → API Keys and select Create key. Keep Key type on Live to get real jobs, or choose Sandbox for free, fictional data (see Sandbox). The key is shown only once. Export it for the examples below:

2. Make a request

Search for software engineering jobs and return the first five:

3. Read the response

Jobs come back in the jobs array. This example is abridged; a full job has up to 28 top-level fields.
See The job object for every field, its type, and its nullability.

Filter the results

Filters match literally, so send canonical values: remote, not Remote; senior, not senior level.
An unknown value matches nothing and an unknown parameter is ignored, both with 200. When a filter seems to do nothing, check total and warnings. There is no is_remote: use work_model (Silent failures).
Search recipes has working combinations for every filter.

If the request fails

Errors lists every status and when to retry.

Test for free

Calls with a sandbox key (jbe_test_…) are never billed. Live search bills per delivered job, so keep page_size small while testing, and use the free endpoints where you can. See Developing without spending.

Next steps

Core concepts

Job identity, freshness, and the 7-day expiry window.

Sync a database

Backfill, then incremental sync with expiry sweeps.

Search recipes

Filter combinations, relevance, facets, and field selection.

API reference

Every endpoint, with request and response schemas.