counts (free)

GET /v1/events/count

Events after a cursor, by kind: how far behind a buyer is

Events after a cursor, by kind, for a cut: how far behind you are before you read them.

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

{
 "cursor": 9600000,
 "top": 9648658,
 "events": {
  "new": 3100,
  "changed": 41000,
  "closed": 2900,
  "reopened": 120
 },
 "total": 47120
}

Example

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

{
 "cursor": 9600000,
 "top": 9648658,
 "events": {
  "new": 3100,
  "changed": 41000,
  "closed": 2900,
  "reopened": 120
 },
 "total": 47120
}

In Python

import json, urllib.request

KEY = "cb_live_XXXXXXXX"
req = urllib.request.Request("https://api.jobmonkey.ai/v1/events/count?country=Canada&cursor=9600000", 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 (free key, 10 a day)

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.