Skip to content
BetterJobs Docs
API v1 preview — endpoints and fields may change before general availability.

All the job data. One request.

BetterJobs sends your job search to our own index and up to six job-data providers, depending on your plan. We merge the results, remove duplicates, and give you one clean list. One key. One bill. You pay only for unique jobs we return.
QuickstartAPI Reference
BetterJobs waterfallYour requestPOST /v1/jobs/searchBetterJobs indexcontributed fieldsReqbeatduplicate, mergedSignalsAPIno matchTheirStackcontributed fieldsJobsPipeduplicate, mergedCoresignalno matchTechmapcontributed fieldsMergededup + scorecanonical jobHead of RevOpsacme-robotics.examplep_real 0.94 · 1 creditsources[]betterjobstheirstacktechmap
Illustrative: one request, seven sources, one canonical job. Duplicates are merged and free.

Without BetterJobs, every job-data provider means a separate signup, key and invoice. With BetterJobs you send one request. It goes to the BetterJobs index and to Reqbeat, SignalsAPI, TheirStack, JobsPipe, Coresignal and Techmap, as your plan allows. The same opening seen by three providers comes back as one canonical job, with every source listed in sources[].

1 credit = 1 unique job returned. Duplicates and empty searches are free. See Credits and billing.

Pick your path

Section titled “Pick your path”
Clay and no-codeAdd a job-search column in Clay, n8n, Make, Zapier or Google Sheets. No code.
DeveloperCall the REST API from your backend. curl, Python and TypeScript.
AI agent builderConnect Claude, Cursor or your own agent over MCP, with credit costs per tool.
Data teamBackfill up to 10,000 jobs per search, then keep a table in sync.
RecruiterFind companies hiring for a role and get told when they start or stop.
Coming from another providerTranslate TheirStack, Coresignal, Techmap or JobsPipe queries and fields.

Hello world

Section titled “Hello world”

Three calls cover most of what people do with BetterJobs. The first needs no key.

Search jobs

Cost: FreeKeyless sandbox. Fixed illustrative data.

Head of RevOps in DACH, posted in the last 7 days. Runs against the keyless sandbox.

Terminal window
curl https://api.betterjobs.cc/v1/sandbox/jobs/search \
  -H "Content-Type: application/json" \
  -d '{"filters":{"title_or":["Head of RevOps"],"country_code_or":["DE","AT","CH"],"posted_within_days":7},"limit":10}'

Quickstart · API reference

Check if a company is hiring

Cost: 1 credit / profile

is_hiring.value is true, false or null. null means unknown, never “not hiring”.

Terminal window
curl https://api.betterjobs.cc/v1/companies/acme-robotics.example \
  -H "Authorization: Bearer $BETTERJOBS_API_KEY" \
  -H "BetterJobs-Version: 2026-10-01"

Find companies hiring · API reference

Watch a company

Cost: 1 credit / job.openedCreating the watch is free. Other events, and jobs you already paid for, are free.

Get a signed webhook when the company opens jobs or starts or stops hiring. Webhooks are listed on the Pro plan and above.

Terminal window
curl https://api.betterjobs.cc/v1/watches \
  -H "Authorization: Bearer $BETTERJOBS_API_KEY" \
  -H "BetterJobs-Version: 2026-10-01" \
  -H "Content-Type: application/json" \
  -d '{"type":"company","domain":"acme-robotics.example","webhook_url":"https://hooks.northwind.example/betterjobs"}'

Detect hiring changes · API reference

All example companies use fictional .example domains. Sample responses are illustrative.

Learn the model

Section titled “Learn the model”
The waterfallHow one request fans out to up to seven sources and comes back as one list.
Canonical jobsWhat one job means when five sources saw it.
Provenance and confidenceWho saw each job, and how sure we are it is real.
ProvidersWhat each of the six partner providers and the BetterJobs index brings.

For machines

Section titled “For machines”