counts (free)

GET /v1/jobs/count

Open jobs, held closures and companies for a cut

Open jobs, held closures among them and companies with a job there, for a cut. Cached 5 minutes per cut in the API. Use it to size a plan: the calculator on /plans reads the same numbers nightly.

Charged: nothing.

Parameters

An unknown parameter is a 400 bad_request. country and system take one value, a comma list (country=Canada,Mexico) or a repeat (country=Canada&country=Mexico); the country is its English name as the data holds it; the system is the ATS name (greenhouse, lever.co, workday, ...): /v1/jobs/count lists the sizes, /docs/sizes shows them.

Answer

{
 "jobs": 91438,
 "held": 2210,
 "companies": 3120,
 "as_of": "2026-11-07T19:35:59Z"
}

Example

curl -s 'https://api.jobmonkey.ai/v1/jobs/count?country=Canada' -H 'Authorization: Bearer cb_live_XXXXXXXX'

{
 "jobs": 81137,
 "held": 1904,
 "companies": 2874,
 "as_of": "2026-11-07T19:35:59Z"
}

In Python

import json, urllib.request

KEY = "cb_live_XXXXXXXX"
req = urllib.request.Request("https://api.jobmonkey.ai/v1/jobs/count?country=Canada", headers={"Authorization": f"Bearer {KEY}"})
with urllib.request.urlopen(req) as r:
    answer = json.load(r)
    print(r.headers.get("X-Request-Id"), r.headers.get("X-Units-Charged"))
print(json.dumps(answer, indent=1)[:800])

Errors

• 400 bad_request
• 401 no_key / bad_key / account_off
• 429 rate_limited
• 429 plan_exhausted (the day's 10 free calls on a free key)

Headers

• X-Request-Id
• X-Units-Charged
• RateLimit (limit=10, remaining=n, reset=s)
• RateLimit-Policy (10;w=1, plus 10;w=86400 on a free key calling a free route)
• X-Plan-Jobs-Remaining (the full feed and snapshots, when the plan has a cap)
• X-Account: past_due (while an invoice is unpaid)

Every answer carries X-Request-Id; quote it to [email protected]. Times are UTC, ISO 8601.