# Job Monkey API

> Clean, open jobs with GUIDs, kept current. One key, JSON, cursors that never skip. The one thing charged is a full job returned by the full feed; events, updates, companies and counts are free. Docs: https://www.jobmonkey.ai/docs/ ; OpenAPI: https://www.jobmonkey.ai/openapi.json ; free key: https://app.jobmonkey.ai/signup

## Routes

- GET /v1/jobs: Full jobs by cursor: a first load cut to countries and systems (charged: every full job in the answer, every time). Docs: https://www.jobmonkey.ai/docs/get-v1-jobs
- POST /v1/jobs: Full jobs by GUID (up to 1,000); closed or unknown GUIDs come back free in `missing` (charged: every full job in the answer, every time; a GUID in `missing` is free). Docs: https://www.jobmonkey.ai/docs/post-v1-jobs
- GET /v1/jobs/count: Open jobs, held closures and companies for a cut (charged: nothing). Docs: https://www.jobmonkey.ai/docs/get-v1-jobs-count
- GET /v1/events: Job events after a cursor: new, changed (with the new values), closed, reopened (charged: nothing). Docs: https://www.jobmonkey.ai/docs/get-v1-events
- GET /v1/updates: Changed fields with their new values: the events stream filtered to `changed` (charged: nothing). Docs: https://www.jobmonkey.ai/docs/get-v1-updates
- GET /v1/events/count: Events after a cursor, by kind: how far behind a buyer is (charged: nothing). Docs: https://www.jobmonkey.ai/docs/get-v1-events-count
- GET /v1/companies: Companies in GUID order for a cut, or by GUID (`guid=a,b,c`) (charged: nothing). Docs: https://www.jobmonkey.ai/docs/get-v1-companies
- GET /v1/companies/events: Company changes after a cursor (the same ledger numbers as the job events) (charged: nothing). Docs: https://www.jobmonkey.ai/docs/get-v1-companies-events
- GET /v1/search: Title search over open jobs: shape=page (the card) or shape=match (GUIDs for a campaign) (charged: nothing). Docs: https://www.jobmonkey.ai/docs/get-v1-search
- GET /v1/snapshots: The newest weekly snapshot: its files, their jobs, bytes and sha256 (charged: nothing for the list). Docs: https://www.jobmonkey.ai/docs/get-v1-snapshots
- POST /v1/snapshots/{stamp}/{file}: A 24-hour link to one snapshot file (`everything` or a country); the file's jobs are charged once (charged: the file's jobs, once, at link time; a second link for the same file inside 24 hours is free; the companies file comes free). Docs: https://www.jobmonkey.ai/docs/post-v1-snapshots-stamp-file
- GET /v1/health: 200 when every database answers (charged: nothing; no key). Docs: https://www.jobmonkey.ai/docs/get-v1-health

## Prices

Pay as you go $1.20 per 1,000 jobs; Pro 100k $99 a month for 100,000 jobs, overage $1.20 per 1,000; Scale 500k $349 a month for 500,000 jobs, overage $0.90 per 1,000; Volume 2M $999 a month for 2,000,000 jobs, overage $0.60 per 1,000; free: 250 jobs a month, no card, no end date.


---

<!-- https://www.jobmonkey.ai/docs/start-here -->

# Start here

Five minutes, three steps, nothing to install beyond `curl`.

## 1. Get a free key

[Sign up](https://app.jobmonkey.ai/signup) with your email. Click the link in the mail, set a password, and your first key is on the screen, once. Copy it somewhere safe: we keep only its first twelve characters.

The free plan has no end date: 250 full jobs and 25 full-feed calls a month, 10 calls a day on the free routes (events, updates, companies, counts). No card.

## 2. Count before you load

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

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

Counts are free. `held` are closures we are still checking (see [Held closures](/docs/held-closures)); `jobs` includes them.

## 3. Read your first page

```
curl -s 'https://api.jobmonkey.ai/v1/jobs?country=Canada&limit=2' \
  -H 'Authorization: Bearer cb_live_XXXXXXXX'
```

The answer holds two full jobs, `next` (the cursor for the next page), `more`, `ledger_seq` and `charged: 2`. Two of your 250 free jobs are used. Every field of a job is in [Fields](/docs/fields).

The same in Python, standard library only:

```python
import json, urllib.request

KEY = "cb_live_XXXXXXXX"
req = urllib.request.Request("https://api.jobmonkey.ai/v1/jobs?country=Canada&limit=2",
                             headers={"Authorization": f"Bearer {KEY}"})
with urllib.request.urlopen(req) as r:
    page = json.load(r)
for job in page["jobs"]:
    print(job["job_guid"], job["title"], job["company"])
print("next:", page["next"], "ledger_seq:", page["ledger_seq"])
```

## What is next

- [Your first sync in three calls](/docs/first-sync): load once, then read events, then fetch by GUID.
- [The cursor](/docs/cursor): why it never skips and how to keep it.
- [Prices](/docs/prices): what is charged (one thing) and what is not (everything else).

Every answer carries `X-Request-Id`; quote it when you write to support@jobmonkey.ai.


---

<!-- https://www.jobmonkey.ai/docs/first-sync -->

# Your first sync in three calls

A sync is three calls, and only one of them costs money.

| Call | What it does | Charged |
|---|---|---|
| `GET /v1/jobs` (or a snapshot file) | the first load of your cut, page by page in GUID order | every full job, once per page |
| `GET /v1/events` | what changed since your cursor: new, changed (with the new values), closed, reopened | nothing |
| `POST /v1/jobs` | the full record of the GUIDs you want after a `new` or `reopened` event | every full job returned |

## 1. The first load

Page your cut until `more` is false. Keep the last page's `ledger_seq`: that is your first cursor.

```
curl -s 'https://api.jobmonkey.ai/v1/jobs?country=Canada&system=greenhouse,lever.co&limit=1000' \
  -H 'Authorization: Bearer cb_live_XXXXXXXX'
```

A job that changed, closed or was born while you were paging is harmless: the same change reaches you as an event from the cursor, and every event is idempotent (set the fields, upsert, drop). Held closures are in the pages, marked by `closing_since`: keep them out of matching while it is set.

For a whole country at once, a [snapshot](/docs/snapshots) file is the same jobs in one download; the price is the same per job.

## 2. Read events from the cursor

```
curl -s 'https://api.jobmonkey.ai/v1/events?country=Canada&system=greenhouse,lever.co&cursor=9648658&limit=10000' \
  -H 'Authorization: Bearer cb_live_XXXXXXXX'
```

Apply each event in `seq` order:

- `new`: fetch the job by GUID (step 3) and insert it.
- `changed`: `fields` holds the served fields that moved with their **new values**; set them. No fetch needed.
- `closed`: drop or hide the job; `closed_at` says when it left its board.
- `reopened`: fetch it again by GUID.

Pass `next` back as `cursor`; when `more` is false you are at `top`. Call as often as you like: events are free and have no daily cap on a paid key.

## 3. Fetch the full records

```
curl -s -X POST https://api.jobmonkey.ai/v1/jobs \
  -H 'Authorization: Bearer cb_live_XXXXXXXX' -H 'Content-Type: application/json' \
  -d '{"guids": ["21b3928d-c2ea-4b3b-8281-7bdf05adbf1b"]}'
```

Up to 1,000 GUIDs a call. A GUID that closed between the event and your call comes back in `missing`, free. Send an `Idempotency-Key` header so a retry after a timeout costs nothing.

## The loop in Python

```python
import json, urllib.request

KEY, API = "cb_live_XXXXXXXX", "https://api.jobmonkey.ai"
CUT = "country=Canada&system=greenhouse,lever.co"

def call(path, body=None):
    data = json.dumps(body).encode() if body else None
    req = urllib.request.Request(API + path, data=data, headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"})
    with urllib.request.urlopen(req) as r:
        return json.load(r)

# 1. the first load
cursor, page = None, {"more": True}
while page["more"]:
    page = call(f"/v1/jobs?{CUT}&limit=1000" + (f"&cursor={page['next']}" if page.get("next") else ""))
    store(page["jobs"])                      # your upsert
    cursor = page["ledger_seq"]

# 2 and 3. every few minutes, for ever
while True:
    ev = call(f"/v1/events?{CUT}&cursor={cursor}&limit=10000")
    want = [e["job_guid"] for e in ev["events"] if e["event"] in ("new", "reopened")]
    for i in range(0, len(want), 1000):
        store(call("/v1/jobs", {"guids": want[i:i + 1000]})["jobs"])
    for e in ev["events"]:
        if e["event"] == "changed": update(e["job_guid"], e["fields"])
        elif e["event"] == "closed": drop(e["job_guid"])
    cursor = ev["next"]
    if not ev["more"]: sleep(300)
```

Store the cursor with your data, in the same transaction. If you lose it, `GET /v1/events?since=<time>` finds the first event at or after a time, and your account page shows the last cursor your key sent.


---

<!-- https://www.jobmonkey.ai/docs/cursor -->

# The cursor

The ledger gives every change a number, `seq`. A cursor is just the last `seq` you applied. `GET /v1/events?cursor=N` answers the events after N for your cut, in order; `next` is the last `seq` of the page, and you pass it back. Company changes (`/v1/companies/events`) use the same numbers, so one cursor covers both streams.

## Why it never skips

The ledger has one writer, and events become visible in `seq` order. A page that is not full ends at the highest `seq` visible to the statement that read it, so nothing can appear later with a lower number than your cursor. You will see every event once, in order, however long you were away.

## Three shapes, one idea

| Route | Cursor shape | Where you get it |
|---|---|---|
| `/v1/events`, `/v1/updates`, `/v1/companies/events`, `/v1/events/count` | a plain `seq`, like `9648658` | `next` or `top` of a previous answer; `ledger_seq` of your first load; a snapshot's `seq` |
| `GET /v1/jobs` | `<seq>:<job_guid>`, like `9648658:21b3928d-...` | `next` of the previous page; the first page has none |
| `GET /v1/companies` | a `company_guid` | `next` of the previous page |

The full feed's cursor carries the ledger's `seq` at the moment the first page was read, so the load and the events that follow line up: read events from that `seq` (the last page's `ledger_seq`) and you miss nothing that happened while you paged.

## A rare cut

A call scans at most 200,000 sequence numbers. A rare country may answer a short page, even an empty one, with `more: true`: that is not the end, call again with `next`. `top` tells you how far the ledger is; `/v1/events/count` tells you how many events wait, by kind.

## `since` instead of a cursor

Lost the cursor? `GET /v1/events?since=2026-11-04T00:00:00Z` starts at the first event at or after that time. It is a fallback, not the loop: times are not unique, numbers are.

## Keep it with your data

Write the cursor in the same transaction as the rows it produced. The account page shows the last cursor each key sent (the `cursor` parameter of your newest `/v1/events` call) as a hint when you have lost yours.

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

```python
cursor = db.one("select cursor from sync_state")      # yours
ev = call(f"/v1/events?country=Canada&cursor={cursor}&limit=10000")
with db.transaction():
    apply(ev["events"])
    db.run("update sync_state set cursor = %s", ev["next"])
```


---

<!-- https://www.jobmonkey.ai/docs/held-closures -->

# Held closures and `closing_since`

Boards go dark for a day: a bad harvest run, a site that timed out, a board being moved. If we closed every job we could not see, you would get a `closed` and a `reopened` for thousands of jobs that never changed. So a closure is **held** first.

## What you see

- While a closure is held, the job is still open in the ledger and in your pages, with `closing_since` set to the time it was last missing. Keep such a job out of matching and search while the field is set; do not drop it yet.
- When the job comes back, `closing_since` goes back to null. **No event is written** for the hold or the return: for you, nothing happened.
- When it does not come back inside the hold (up to 48 hours), one `closed` event is written. Its `at` is when the closure was published; its `closed_at` is when the job last left its board.

## In numbers

`GET /v1/jobs/count` answers `jobs` (open jobs in your cut, held ones included) and `held` (how many of them are held right now). The home page's "jobs live" leaves held closures out.

## What to do

```python
for job in page["jobs"]:
    upsert(job)
    if job["closing_since"]:
        hide(job["job_guid"])          # out of search and matching, still in the store
    else:
        show(job["job_guid"])
```

On a `closed` event, drop the job. On a `reopened` event, fetch it again by GUID (it may have changed while closed): the GUID is the same one it had before.

```
curl -s 'https://api.jobmonkey.ai/v1/events?event=closed,reopened&country=Canada&cursor=9600000' \
  -H 'Authorization: Bearer cb_live_XXXXXXXX'
```

Closed jobs are never served by the full feed: a closed GUID in `POST /v1/jobs` comes back in `missing` with `status: closed` and its `closed_at`, free.


---

<!-- https://www.jobmonkey.ai/docs/not-carried -->

# What the feed does not carry

Know these before you build, and the feed will not surprise you.

1. **No row images on `new` and `reopened`.** The event tells you a job was born or came back; the record comes from `POST /v1/jobs` by GUID. That is the one charged call, and it is why events can be free.
2. **A hold and an unhold write no event.** A job that goes missing from its board and comes back inside 48 hours was never closed for you ([Held closures](/docs/held-closures)). One that does not come back arrives as a single `closed`.
3. **An employer's edit without a served-field change does not reach the feed.** We compare the served fields only; an edit that leaves every one of them the same is not a `changed` event.
4. **`source` never changes.** A job is one row on one system. A company that moves to a new ATS has new jobs with new GUIDs on the new system, and the old ones close.
5. **A job's `company` and `industry` follow the company, not the job.** When a company is renamed or its industry is fixed, you get one event on `/v1/companies/events`, not one per job. Join on `company_guid` and you are right at once.

## Two more things that are not filters

- **No filter beyond the cut.** `country` and `system` are the only parameters that narrow a stream. "Only remote" or "only full-time" is your side: the fields are all there (`ai_workplace_type`, `ai_employment_type`) and the cut keeps the stream cheap to serve and cheap to buy.
- **No webhooks.** You call us; nothing calls you. Events are free and have no daily cap on a paid key, so a loop every few minutes is the design.

## A changed job that moved country

A `changed` event is given as **you** see it: a job that left your countries arrives as `closed`, one that entered as `new`. `ledger_event` keeps the ledger's own word so you can tell the two apart.

```
curl -s 'https://api.jobmonkey.ai/v1/events?country=Canada&cursor=9600000&limit=3' \
  -H 'Authorization: Bearer cb_live_XXXXXXXX' | python3 -c 'import json,sys; [print(e["seq"], e["event"], e["ledger_event"]) for e in json.load(sys.stdin)["events"]]'
```


---

<!-- https://www.jobmonkey.ai/docs/fields -->

# Fields

A job has 50 fields: the GUIDs, the posting's own fields as its board states them, and the fields our models and rules add. **A field that begins with `ai_` is ours**: a model's judgment, a rule, or a default for silence. The list `derived` on each job names the `ai_` fields the posting did not state on that job, so a buyer that wants stated facts only can drop them.

Nothing is ever removed inside `/v1`. New fields are added as new names, each one a `changed` event for every job the day it is filled, and the [changelog](/docs/changelog) says when.

## The job

| Field | Type | Ours | Notes |
|---|---|---|---|
| `job_guid` | uuid |  | born when the job enters the feed, kept on reopen |
| `company_guid` | uuid |  | join to /v1/companies |
| `title` | text |  | the board's title, trimmed by rules; never null |
| `ai_title` | text | yes | the clean title; never null |
| `source` | text |  | the system (lever.co for Lever) |
| `url` | text |  | the employer's page |
| `description` | text |  | full text |
| `requirements` | text |  | full text, ours |
| `benefits` | text |  | full text, ours |
| `ai_workplace_type` | text | yes | On-site, Hybrid, Remote Solely, Remote OK |
| `ai_employment_type` | text | yes | FULL_TIME, PART_TIME, CONTRACTOR, INTERN |
| `ai_experience_level` | text | yes | years, as a text; null on about half the jobs |
| `ai_salary_min` | number | yes | yearly (hourly x 2,080), stated or read from the text |
| `ai_salary_max` | number | yes | yearly |
| `ai_salary_currency` | text | yes | defaults to USD |
| `salary_min` | number |  | as stated; null when none |
| `salary_max` | number |  | as stated |
| `salary_currency` | text |  | as stated |
| `salary_period` | text |  | HOUR, DAY, WEEK, MONTH or YEAR; null when none stated |
| `posted_date` | timestamp |  | never null (first seen when the board gives none) |
| `expiry_date` | timestamp |  | when the board states one |
| `date_modified` | timestamp |  | the board's |
| `first_seen` | timestamp |  | when our harvest first saw the job |
| `ai_job_language` | text | yes | English, French, ... |
| `ai_education` | text | yes | the level named |
| `ai_visa_sponsorship` | boolean | yes | false for silence |
| `location_json` | list |  | places: {city, state, country, lat, lng, precision, guessed}, town level |
| `remote_location_json` | list |  | places a remote job is open to; [] when none |
| `ai_languages` | list | yes | languages the posting asks for |
| `ai_onet_code` | text | yes | O*NET-SOC 2019; '' until filled |
| `ai_onet_title` | text | yes |  |
| `ai_soc_code` | text | yes | SOC 2018 (US); '' until filled |
| `ai_soc_title` | text | yes |  |
| `ai_noc_code` | text | yes | NOC 2021 (Canada); '' until filled |
| `ai_noc_title` | text | yes |  |
| `ai_isco_code` | text | yes | ISCO-08; '' until filled |
| `ai_isco_title` | text | yes |  |
| `ai_esco_code` | text | yes | ESCO; '' until filled |
| `ai_esco_title` | text | yes |  |
| `ai_summary` | text | yes | '' until the summary pass runs |
| `ai_skills` | list | yes | [] until filled |
| `ai_keywords` | list | yes | [] until filled |
| `countries` | list |  | what the country cut filters on |
| `timezones` | list |  | one IANA zone per place, in place order |
| `derived` | list |  | the ai_ fields the posting did not state on this job |
| `company` | text |  | the company's name; '' for a nameless board |
| `industry` | text |  | the company's industry, the short name |
| `is_active` | boolean |  | always true (open jobs only) |
| `sync_status` | text |  | always Active |
| `closing_since` | timestamp |  | set while a closure is held: keep the job out of matching |

Types: `text`, `number`, `boolean`, `timestamp` (UTC, ISO 8601 with `Z`), `list` (a JSON array), `uuid`. A `text` that a model has not filled yet is `""`, never null; a `list` is `[]`.

## The company

A job's `company` and `industry` are its company's `name` and `industry`, denormalised; the rest of a company comes from `/v1/companies` by `company_guid`.

| Field | Type | Notes |
|---|---|---|
| `company_guid` | uuid |  |
| `name` | text | '' when the board was imported with no name |
| `slug` | text | the board's key |
| `url` | text | the company's site |
| `size` | text | the employees band |
| `industry` | text | the short name |
| `locations` | list | a list |
| `ats` | text | the system |
| `ats_site` | text | the board's site |
| `board_name` | text | as the board names itself |
| `parent_company_guid` | uuid | the parent, when known |
| `slug_verified` | boolean | the slug was checked |

## Occupation codes

`ai_onet_code` and `ai_onet_title` (O*NET-SOC 2019, under CC BY 4.0; see [Credits](/credits)), `ai_soc_code` (SOC 2018, US), `ai_noc_code` (NOC 2021, Canada), `ai_isco_code` (ISCO-08, ILO) and `ai_esco_code` (ESCO, EU), each with its title. They are `""` until the occupation pass fills them; the names are fixed now so nothing is renamed later.

## Places

`location_json` is a list of places, each `{city, state, country, lat, lng, precision, guessed}`. Places are at town level, never a street address; `lat` and `lng` are the town centre from GeoNames (CC BY 4.0), null only for a place we could not match. `timezones` has one IANA zone per place in the same order; `countries` is the list the cut filters on. `remote_location_json` lists the places a remote job is open to, `[]` when none are stated.


---

<!-- https://www.jobmonkey.ai/docs/snapshots -->

# Snapshots

A snapshot is the newest weekly copy of every open job, one file for everything and one per country, as zstd-compressed JSON lines in the API's exact shape. For a first load of a whole country it is the same jobs as paging `GET /v1/jobs`, in one download, from Cloudflare's edge, not from our line.

## The price

**The same as the pages**: every job in the file is charged once, at your plan's rate, when the link is made. The companies file of the same folder comes free. A second link for the same file inside 24 hours is free. A plan too small for the file gets `429 plan_exhausted` and nothing is charged.

A buyer who pays for a snapshot and then pages the same jobs through `GET /v1/jobs` pays twice: load the snapshot, then read events.

## Three calls

```
curl -s https://api.jobmonkey.ai/v1/snapshots -H 'Authorization: Bearer cb_live_XXXXXXXX'
```

Lists the newest snapshot: its `stamp`, `taken_at`, the ledger `seq` to read events from, and per file the `jobs`, `bytes` and `sha256`.

```
curl -s -X POST https://api.jobmonkey.ai/v1/snapshots/20261107-191824Z/canada -H 'Authorization: Bearer cb_live_XXXXXXXX'
```

Answers `url` and `companies_url`, each good for 24 hours, and `charged`.

```
curl -sL "$URL" -o canada.jsonl.zst && zstd -d canada.jsonl.zst
```

A country file is concatenated frames in one stream; plain `zstd -d` reads it. Check the `sha256`.

## Then read events

The snapshot's `seq` is your first cursor: `GET /v1/events?country=Canada&cursor=<seq>` gives everything that moved since the file was written. Held closures are in the file, marked by `closing_since`, for the same reason they are in the pages.

```python
import json, subprocess, urllib.request

KEY, API = "cb_live_XXXXXXXX", "https://api.jobmonkey.ai"
def call(path, method="GET"):
    req = urllib.request.Request(API + path, method=method, headers={"Authorization": f"Bearer {KEY}"})
    with urllib.request.urlopen(req) as r:
        return json.load(r)

snap = call("/v1/snapshots")
link = call(f"/v1/snapshots/{snap['snapshot']['stamp']}/canada", "POST")
urllib.request.urlretrieve(link["url"], "canada.jsonl.zst")
subprocess.run(["zstd", "-d", "-f", "canada.jsonl.zst"], check=True)
with open("canada.jsonl") as f:
    for line in f:
        store(json.loads(line))
cursor = snap["snapshot"]["seq"]
```

The free [sample file](/sample) is 1,000 jobs in the same shape, gzipped, no key: test your parser on it first.


---

<!-- https://www.jobmonkey.ai/docs/sizes -->

# Sizes by country and system

What the [calculator](/plans) sums when you pick a cut. Counted nightly from the same tables the API serves; `GET /v1/jobs/count` gives the exact number for any cut at the time of the call. Jobs live leaves held closures out. As of 2026-11-07T23:27:00+00:00 UTC.
## Countries

| Country | Jobs live | Companies | New in 30 days |
|---|---|---|---|
| United States | 1,891,082 | 52,806 | 589,059 |
| India | 123,984 | 3,544 | 32,055 |
| United Kingdom | 105,970 | 6,582 | 37,304 |
| Canada | 89,505 | 5,975 | 25,599 |
| Germany | 88,345 | 6,450 | 17,246 |
| France | 70,212 | 2,633 | 14,187 |
| Australia | 30,149 | 2,390 | 8,606 |
| Mexico | 29,165 | 1,990 | 7,853 |
| Netherlands | 27,796 | 2,651 | 5,077 |
| China | 22,251 | 1,340 | 4,384 |
| Singapore | 21,137 | 1,827 | 3,722 |
| Spain | 20,915 | 2,223 | 4,862 |
| Malaysia | 19,114 | 1,063 | 3,405 |
| Philippines | 17,286 | 1,368 | 3,121 |
| Brazil | 16,212 | 1,674 | 4,573 |
| Poland | 14,835 | 1,694 | 3,116 |
| United Arab Emirates | 14,825 | 1,164 | 3,426 |
| Japan | 12,638 | 1,451 | 2,026 |
| Italy | 10,701 | 1,433 | 2,761 |
| Sweden | 10,507 | 1,406 | 2,067 |
| Ireland | 9,939 | 1,246 | 2,362 |
| Indonesia | 9,673 | 674 | 1,587 |
| Belgium | 8,722 | 1,299 | 1,486 |
| Switzerland | 8,126 | 1,540 | 1,766 |
| Taiwan | 8,113 | 683 | 1,560 |
| Thailand | 8,044 | 797 | 1,829 |
| Colombia | 8,005 | 1,057 | 1,678 |
| Portugal | 7,870 | 963 | 1,347 |
| Saudi Arabia | 7,779 | 666 | 1,181 |
| South Africa | 7,371 | 922 | 1,694 |
| Greece | 6,390 | 588 | 778 |
| Vietnam | 5,565 | 632 | 1,205 |
| Romania | 5,438 | 781 | 1,242 |
| Hong Kong | 5,422 | 810 | 906 |
| Argentina | 5,145 | 872 | 1,091 |
| Peru | 4,682 | 430 | 1,004 |
| South Korea | 4,423 | 818 | 866 |
| Egypt | 4,314 | 488 | 987 |
| New Zealand | 4,282 | 649 | 1,129 |
| Austria | 4,231 | 763 | 1,665 |
| Denmark | 3,999 | 759 | 911 |
| Puerto Rico | 3,971 | 377 | 1,148 |
| Czech Republic | 3,900 | 695 | 834 |
| Chile | 3,725 | 517 | 806 |
| Hungary | 3,714 | 569 | 845 |
| Norway | 3,442 | 615 | 653 |
| Israel | 3,295 | 510 | 876 |
| Ukraine | 2,891 | 376 | 433 |
| Bulgaria | 2,789 | 439 | 550 |
| Nigeria | 2,769 | 295 | 391 |
| Morocco | 2,735 | 291 | 423 |
| Turkey | 2,544 | 527 | 712 |
| Qatar | 2,498 | 190 | 742 |
| Finland | 2,423 | 487 | 552 |
| Costa Rica | 2,349 | 424 | 669 |
| Pakistan | 2,040 | 254 | 377 |
| Serbia | 1,795 | 394 | 396 |
| Luxembourg | 1,569 | 287 | 288 |
| Georgia | 1,329 | 334 | 297 |
| Cyprus | 1,327 | 224 | 194 |
| Jordan | 1,295 | 196 | 290 |
| Lithuania | 1,293 | 237 | 290 |
| Kenya | 1,241 | 242 | 276 |
| Guatemala | 1,197 | 185 | 266 |
| Slovakia | 1,168 | 270 | 301 |
| Lebanon | 1,156 | 105 | 120 |
| Ecuador | 1,151 | 172 | 170 |
| Malta | 1,149 | 202 | 166 |
| Sri Lanka | 948 | 121 | 287 |
| Croatia | 938 | 230 | 212 |
| Dominican Republic | 897 | 168 | 255 |
| Panama | 887 | 221 | 209 |
| Tunisia | 878 | 154 | 123 |
| Kuwait | 850 | 125 | 238 |
| Uruguay | 780 | 180 | 123 |
| Maldives | 732 | 26 | 161 |
| Tanzania | 719 | 81 | 72 |
| Ghana | 690 | 125 | 181 |
| Kazakhstan | 670 | 172 | 112 |
| Estonia | 665 | 211 | 156 |
| Mauritius | 659 | 86 | 106 |
| Latvia | 612 | 157 | 163 |
| El Salvador | 597 | 108 | 127 |
| Slovenia | 591 | 156 | 168 |
| Honduras | 578 | 123 | 123 |
| Sao Tome and Principe | 555 | 67 | 121 |
| Bahrain | 547 | 83 | 137 |
| Oman | 526 | 93 | 119 |
| Worldwide | 507 | 6 | 21 |
| Armenia | 502 | 111 | 68 |
| Venezuela | 499 | 111 | 114 |
| Jamaica | 457 | 93 | 104 |
| Nicaragua | 444 | 68 | 108 |
| Algeria | 431 | 106 | 99 |
| Russia | 390 | 66 | 174 |
| Uganda | 341 | 79 | 96 |
| Bahamas | 340 | 39 | 59 |
| Belize | 336 | 25 | 218 |
| Uzbekistan | 335 | 66 | 40 |
| Ethiopia | 324 | 84 | 100 |
| Iraq | 319 | 62 | 98 |
| New Caledonia | 311 | 8 | 34 |
| North Macedonia | 306 | 89 | 63 |
| Bangladesh | 289 | 91 | 104 |
| Cayman Islands | 284 | 85 | 116 |
| Kosovo | 279 | 38 | 64 |
| Bermuda | 264 | 57 | 35 |
| Ivory Coast | 261 | 102 | 38 |
| Guam | 248 | 64 | 46 |
| Azerbaijan | 247 | 100 | 53 |
| Albania | 245 | 99 | 77 |
| Zambia | 244 | 78 | 68 |
| Bosnia and Herzegovina | 241 | 77 | 58 |
| Nepal | 241 | 50 | 96 |
| Barbados | 239 | 38 | 74 |
| Bolivia | 239 | 62 | 38 |
| Guyana | 230 | 36 | 41 |
| Paraguay | 228 | 84 | 45 |
| Democratic Republic of the Congo | 227 | 59 | 115 |
| Moldova | 225 | 77 | 45 |
| Cambodia | 221 | 62 | 70 |
| Jersey | 217 | 54 | 61 |
| Angola | 199 | 57 | 44 |
| Aruba | 192 | 23 | 111 |
| Senegal | 188 | 68 | 26 |
| Cuba | 182 | 38 | 65 |
| Suriname | 181 | 34 | 38 |
| Madagascar | 170 | 37 | 104 |
| Rwanda | 170 | 52 | 40 |
| Trinidad and Tobago | 166 | 39 | 28 |
| Antarctica | 163 | 5 | 5 |
| Macao | 161 | 34 | 29 |
| U.S. Virgin Islands | 159 | 37 | 37 |
| Mozambique | 156 | 51 | 42 |
| Seychelles | 143 | 16 | 17 |
| Papua New Guinea | 141 | 46 | 22 |
| Namibia | 134 | 53 | 66 |
| Laos | 133 | 51 | 30 |
| Monaco | 127 | 35 | 10 |
| Gibraltar | 120 | 30 | 20 |
| Cameroon | 114 | 48 | 22 |
| Fiji | 114 | 32 | 64 |
| Guernsey | 110 | 38 | 30 |
| Belarus | 109 | 34 | 31 |
| Montenegro | 105 | 47 | 15 |
| Iceland | 104 | 42 | 32 |
| Haiti | 99 | 34 | 36 |
| Turks and Caicos Islands | 97 | 10 | 11 |
| Marshall Islands | 95 | 9 | 90 |
| Benin | 94 | 31 | 20 |
| Myanmar | 88 | 37 | 43 |
| Malawi | 84 | 39 | 24 |
| Grenada | 78 | 6 | 7 |
| Mongolia | 73 | 36 | 19 |
| Saint Lucia | 73 | 11 | 7 |
| Liechtenstein | 72 | 23 | 15 |
| Iran | 70 | 16 | 15 |
| South Sudan | 69 | 24 | 19 |
| Zimbabwe | 69 | 28 | 14 |
| Guinea | 66 | 21 | 17 |
| Afghanistan | 65 | 22 | 32 |
| Isle of Man | 65 | 36 | 19 |
| Chad | 60 | 23 | 18 |
| French Guiana | 59 | 13 | 5 |
| French Polynesia | 59 | 16 | 8 |
| Syria | 57 | 29 | 21 |
| Burkina Faso | 56 | 22 | 19 |
| Kyrgyzstan | 55 | 27 | 13 |
| Eswatini | 54 | 17 | 13 |
| Palestine | 54 | 22 | 11 |
| Togo | 54 | 22 | 15 |
| Sint Maarten | 53 | 10 | 15 |
| Timor Leste | 53 | 12 | 12 |
| Gambia | 52 | 15 | 6 |
| Curacao | 51 | 24 | 18 |
| Botswana | 50 | 27 | 11 |
| Guadeloupe | 50 | 18 | 16 |
| Martinique | 50 | 21 | 6 |
| Mali | 48 | 24 | 13 |
| Gabon | 47 | 18 | 8 |
| PR | 46 | 1 | 0 |
| Antigua and Barbuda | 43 | 6 | 2 |
| Tonga | 42 | 11 | 39 |
| Equatorial Guinea | 41 | 12 | 3 |
| Solomon Islands | 38 | 11 | 20 |
| Libya | 37 | 12 | 11 |
| Tajikistan | 36 | 17 | 13 |
| Burundi | 35 | 12 | 5 |
| Reunion | 34 | 17 | 5 |
| Sierra Leone | 34 | 24 | 14 |
| Samoa | 33 | 16 | 18 |
| Somalia | 33 | 14 | 23 |
| Sudan | 33 | 18 | 21 |
| Mauritania | 32 | 7 | 5 |
| Saint Vincent and the Grenadines | 32 | 6 | 1 |
| Saint Kitts and Nevis | 30 | 4 | 3 |
| Brunei | 29 | 15 | 2 |
| Lesotho | 27 | 18 | 13 |
| Liberia | 27 | 18 | 6 |
| Republic of the Congo | 26 | 14 | 8 |
| British Virgin Islands | 25 | 16 | 7 |
| Niger | 25 | 17 | 2 |
| Djibouti | 22 | 6 | 10 |
| Yemen | 19 | 10 | 4 |
| American Samoa | 18 | 13 | 7 |
| British Indian Ocean Territory | 18 | 1 | 1 |
| Andorra | 16 | 10 | 4 |
| Comoros | 16 | 4 | 3 |
| Micronesia | 16 | 9 | 14 |
| Anguilla | 15 | 3 | 2 |
| Bonaire, Saint Eustatius and Saba  | 15 | 2 | 1 |
| North Korea | 15 | 3 | 2 |
| Turkmenistan | 15 | 5 | 6 |
| Cabo Verde | 14 | 4 | 1 |
| Greenland | 14 | 7 | 5 |
| Central African Republic | 13 | 12 | 1 |
| NI | 11 | 1 | 1 |
| Korea, Republic of | 10 | 3 | 3 |
| Mayotte | 10 | 5 | 0 |
| Bhutan | 9 | 6 | 2 |
| Saint Helena | 9 | 2 | 9 |
| HN | 8 | 1 | 0 |
| Palau | 8 | 3 | 1 |
| Aland Islands | 7 | 3 | 1 |
| Northern Mariana Islands | 7 | 4 | 5 |
| Saint Martin | 6 | 4 | 0 |
| Vanuatu | 6 | 4 | 0 |
| XX | 6 | 1 | 0 |
| Netherlands Antilles | 5 | 2 | 0 |
| Dominica | 4 | 3 | 2 |
| Serbia and Montenegro | 4 | 2 | 0 |
| Faroe Islands | 3 | 2 | 0 |
| Kiribati | 3 | 1 | 1 |
| Macedonia | 3 | 1 | 0 |
| Saint Barthelemy | 3 | 2 | 0 |
| San Marino | 3 | 2 | 1 |
| Time | 3 | 1 | 0 |
| Cocos Islands | 2 | 1 | 0 |
| Guinea-Bissau | 2 | 2 | 1 |
| Virgin Islands (U.S.) | 2 | 1 | 0 |
| California | 1 | 1 | 1 |
| Falkland Islands | 1 | 1 | 0 |
| Remote - Global | 1 | 1 | 1 |
| Saint Pierre and Miquelon | 1 | 1 | 0 |
| Svalbard and Jan Mayen | 1 | 1 | 0 |
| Vatican | 1 | 1 | 0 |
| Viet Nam | 1 | 1 | 0 |
| CSL Plasma | 0 | 1 | 0 |

## Systems

The `system` value is the name in the first column (`lever.co` for Lever).

| System | Jobs live | Companies | New in 30 days |
|---|---|---|---|
| `oracle` | 557,912 | 2,069 | 133,040 |
| `workday` | 496,349 | 4,012 | 139,119 |
| `icims` | 367,442 | 3,027 | 204,814 |
| `smartrecruiters` | 252,023 | 1,573 | 46,616 |
| `greenhouse` | 197,751 | 7,063 | 100,775 |
| `paycom` | 119,412 | 5,936 | 15,011 |
| `paylocity` | 102,073 | 8,375 | 13,483 |
| `adp` | 99,244 | 6,029 | 13,763 |
| `dayforce` | 76,092 | 1,471 | 29,103 |
| `ashby` | 65,117 | 3,966 | 8,910 |
| `lever.co` | 64,221 | 2,033 | 16,247 |
| `workable` | 54,406 | 2,637 | 6,390 |
| `bamboohr` | 44,154 | 6,406 | 5,910 |
| `jazzhr` | 37,773 | 2,137 | 14,604 |
| `recruitee` | 34,945 | 2,316 | 3,313 |
| `breezy` | 33,001 | 1,880 | 4,488 |
| `teamtailor` | 29,945 | 2,195 | 6,788 |
| `applicantpro` | 28,050 | 1,449 | 8,227 |
| `personio` | 27,518 | 3,073 | 4,009 |
| `cornerstone` | 23,501 | 434 | 8,551 |
| `jobvite` | 23,050 | 442 | 15,582 |
| `successfactors` | 22,823 | 88 | 5,127 |
| `ukg` | 19,344 | 707 | 2,408 |
| `zoho` | 13,977 | 622 | 1,532 |
| `pinpoint` | 10,698 | 325 | 1,491 |
| `rippling` | 9,843 | 1,223 | 1,156 |
| `taleo` | 9,111 | 71 | 2,710 |
| `eightfold` | 5,470 | 18 | 2,884 |
| `gem` | 4,382 | 589 | 2,644 |
| `dover` | 549 | 88 | 117 |


---

<!-- https://www.jobmonkey.ai/docs/prices -->

# Prices

**One thing is charged: a full job returned by the full feed** (`GET /v1/jobs`, `POST /v1/jobs`, and a snapshot file), every time it is returned. Events, updates, companies, counts and search cost nothing, and a paid key has no request quota on them. Prices in USD a month, tax on top where it applies, cancel any time.

| Offer | Jobs a month | $ a month | $ per 1,000 |
|---|---|---|---|
| Free | 250 jobs, 25 full-feed calls; 10 free-route calls a day | 0 | |
| Pay as you go | any; a card on file, billed at month end | | 1.20 |
| Pro 100k | 100,000; overage at $1.20 per 1,000 | 99 | 0.99 |
| Scale 500k | 500,000; overage at $0.90 per 1,000 | 349 | 0.70 |
| Volume 2M | 2,000,000; overage at $0.60 per 1,000 | 999 | 0.50 |
| Custom | above 2,000,000, resellers, bulk to a bucket | by email to sales@jobmonkey.ai | from 0.40 |

## The free taste

Every new account has 250 full jobs and 25 full-feed calls a month, and 10 calls a day (UTC) on the free routes, with no end date and no card. Over it you get `429 plan_exhausted` with `Retry-After` to the next day or month. A free account holds one live key.

## Overage and the spend cap

A plan's jobs are a month's allowance. Past them, overage runs at the plan's rate per 1,000 jobs, up to a **spend cap** you set on the billing page (the default is the plan's price again; Pro 100k at $99 may spend another $99 on overage). At the cap the full feed answers `429 plan_exhausted` until the month turns or you raise the cap. A call that would pass the cap is **cut to what is left** and charged for that, so you never pay past the cap and never lose a page you paid for. `X-Plan-Jobs-Remaining` on every full-feed answer tells you where you stand; the account page and a mail at 80% do too.

Pay as you go has a default cap of $100 a month; change it on the billing page.

## The first load

The first load is priced like any other job. A whole-country file is big: the United States is about 1.6 million jobs, which a Volume 2M plan covers inside its month. A buyer on a smaller plan is cheaper taking Volume 2M for the first month and changing down after.

## Upgrade, downgrade, cancel

All three live on your [billing page](https://app.jobmonkey.ai/account/billing). An upgrade or a downgrade changes the plan at once with a prorated invoice line. Cancel stops the plan at the end of the period; your account goes back to the free taste and your key keeps working inside it. Invoices and your card are in the Stripe portal, from the same page.

## Past due

If an invoice fails, Stripe retries the card and mails you. Your key keeps working for 7 days with `X-Account: past_due` on every answer; after 7 days the account goes off and every call answers `401 account_off` until the invoice is paid.

## The headers

| Header | Meaning |
|---|---|
| `X-Units-Charged` | full jobs charged by this answer |
| `X-Plan-Jobs-Remaining` | jobs left this month inside the plan and the cap (full feed and snapshots) |
| `RateLimit`, `RateLimit-Policy` | the 10 calls a second per key, and the 10 a day on a free key's free routes |
| `X-Request-Id` | quote it to support |


---

<!-- https://www.jobmonkey.ai/docs/changelog -->

# Changelog

Dated entries, newest first. Nothing is ever removed inside `/v1`; a rename lands as a new name beside the old one for at least one release.

## 2026-11-07

- The website and the account app open: sign-up with a free key at once, the plans, the calculator, these docs, the status page and the free [sample file](/sample).
- The API serves at `api.jobmonkey.ai`: `/v1/jobs` (GET by cursor, POST by GUID), `/v1/events`, `/v1/updates`, `/v1/companies`, `/v1/companies/events`, `/v1/jobs/count`, `/v1/events/count`, `/v1/snapshots`, `/v1/health`. Search (`/v1/search`) is house-only for now.
- Prices as on [Prices](/docs/prices): pay as you go at $1.20 per 1,000 jobs; Pro 100k $99, Scale 500k $349, Volume 2M $999; a free taste with no end date.
- Snapshots: the newest weekly file per country from the edge, priced like the pages, 24-hour links.

## 2026-11-06

- **Renamed**: the fields our models make now begin with `ai_`: `title` -> `ai_title` (and `title` is now the board's title trimmed by rules), `workplace_type` -> `ai_workplace_type`, `employment_type` -> `ai_employment_type`, `experience_level` -> `ai_experience_level`, `job_language` -> `ai_job_language`, `education` -> `ai_education`, `visa_sponsorship` -> `ai_visa_sponsorship`, `languages` -> `ai_languages`, `summary` -> `ai_summary`, `onet_code` -> `ai_onet_code`.
- **Renamed**: `min_salary`, `max_salary`, `salary_currency` -> `ai_salary_min`, `ai_salary_max`, `ai_salary_currency` (the yearly figures). **Added** `salary_min`, `salary_max`, `salary_currency`, `salary_period`: the salary as the posting states it, before any conversion; all null when none is stated.
- **Added** `derived`: the `ai_` fields the posting did not state on this job.
- **Added** `timezones`: one IANA zone per place, in the order of `location_json`.
- **Added**, as placeholders filled later: `ai_skills`, `ai_keywords` (`[]`), `ai_summary` (`""`), and the occupation codes `ai_onet_title`, `ai_soc_code`, `ai_soc_title`, `ai_noc_code`, `ai_noc_title`, `ai_isco_code`, `ai_isco_title`, `ai_esco_code`, `ai_esco_title` (`""`).

## 2026-11-05

- **Added** `first_seen`: when our harvest first saw the job. Measure our freshness against `posted_date` with it.