Recruitee Jobs API - Career Site Job Scraper

Job postings pulled straight from company career sites running Recruitee, with a verified directory of 805 Recruitee boards included so you never have to guess a company's board slug.

Recruitee serves each company's offers from its own subdomain in one call. Recruitee publishes no job count, so completeness is reported as unknown rather than assumed.

Why this exists

Most job data on the market is scraped from aggregators, where postings are reposted, stale, or routed through a third-party apply flow. These come from the employer's own Recruitee board: one hop from the hiring team, with the employer's real apply URL.

Completeness is reported honestly

Recruitee returns a whole board in one call, so there is no pagination that could silently truncate. But Recruitee publishes no job count, so there is nothing to check against - and this Actor reports null for that board rather than claiming a completeness it cannot prove.

What you get

Field	Meaning
company	Employer name
title	Role title
location	Location as the employer wrote it
department	Team or department, when the board exposes one
url	Direct apply URL on the employer's board
updated	Posting or last-updated timestamp from the vendor
board_token	The Recruitee board identifier, reusable in later runs
job_id	Vendor's own job id
verified_complete	true, false, or null - see below

Every run also writes a PROVENANCE record to the key-value store: per board, how many postings were fetched, what count the vendor published, and whether the two matched.

verified_complete is three-valued on purpose

• true - the vendor published a count and our row count matched it.
• false - the vendor published a count and we did not match it. Something is wrong; the run tells you rather than hiding it.
• null - the vendor publishes no count. Honestly unknown.

Most job scrapers report only what they found. That is indistinguishable from a board that half-failed. A silent partial result is worse than an error, because you build on it.

Input

Option	What it does
companies	Company names. Resolved against the verified directory first, then live.
boards	Exact Recruitee board tokens, if you already know them.
listKnownBoards	Return the whole verified directory of 805 boards instead of jobs.
allBoards	Sweep directory boards when no company is given.
keyword	Case-insensitive filter on job title.
maxBoards	Cap boards per run (default 25).
maxResults	Cap rows returned.

Start here

Set listKnownBoards to true. You get every Recruitee board we have confirmed live, and can pick the companies you care about from real tokens instead of guessing.

Platform notes

Boards live at <company>.recruitee.com, so the board token is the subdomain.

Where the directory comes from

Board tokens are harvested from public web crawl archives, then every one is re-checked against Recruitee's own public API before it ships. A token that was seen once but no longer resolves does not make it in. Guessing company slugs instead was measured at a 0.77% hit rate; this approach measured about 67%.

To be exact about what the directory is: a board qualifies when it resolved and had at least one open role at validation time. A real board that happened to be empty that day is not in here. So treat the count as a floor, not a census.

Legal

This Actor reads Recruitee's documented public job board endpoints - the same data any visitor sees without logging in. No login, no cookies, no terms accepted, no paywall or access control circumvented. Job postings are published by employers specifically to be seen.

Limits

• Coverage is the directory plus anything you name explicitly; it is not every Recruitee board in existence, and this README says so rather than implying totals.
• updated is passed through from the vendor and means slightly different things on different platforms.
• Rate limits are the vendor's, not ours. Errors are reported per board.