Quickstart - bossradar

1. Get your API key

Sign in and open the dashboard. Your key (brk_live_…) is already there — copy it. Send it on every request as the X-API-Key header.

2. Submit a company

curl -X POST https://api.bossradar.com/jobs \
  -H "X-API-Key: brk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "input": "linkedin.com/company/anthropic" }'

import requests

r = requests.post(
    "https://api.bossradar.com/jobs",
    headers={"X-API-Key": "brk_live_..."},
    json={"input": "linkedin.com/company/anthropic"},
)
print(r.json())  # { "job_id": "...", "status": "processing" }

const r = await fetch("https://api.bossradar.com/jobs", {
  method: "POST",
  headers: { "X-API-Key": "brk_live_...", "Content-Type": "application/json" },
  body: JSON.stringify({ input: "linkedin.com/company/anthropic" }),
});
console.log(await r.json()); // { job_id, status: "processing" }

You get back a job_id and 202 immediately — the work runs in the background.

3. Get the results — poll or webhook

Poll
Webhook

curl https://api.bossradar.com/jobs/<job_id> -H "X-API-Key: brk_live_..."
# → { "status": "done", "company_id": 3384253, "result_url": "/company/3384253/dm" }

curl https://api.bossradar.com/company/3384253/dm -H "X-API-Key: brk_live_..."
# → { "company_id": 3384253, "count": 5, "decision_makers": [ ... ] }

Pass callback_url on POST /jobs:

curl -X POST https://api.bossradar.com/jobs \
  -H "X-API-Key: brk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "input": "linkedin.com/company/anthropic",
        "callback_url": "https://your-server.com/hooks/bossradar" }'

When the job is done we POST your URL with:

{ "job_id": "...", "company_id": 3384253, "status": "done", "count": 5, "decision_makers": [ ... ] }

Try any of this live — the API Reference has an interactive playground with your key ready to go.

​1. Get your API key

​2. Submit a company

​3. Get the results — poll or webhook

1. Get your API key

2. Submit a company

3. Get the results — poll or webhook