Files
jobboard/plugins

Where roles come from

This file lists every source roledesk reads roles from, how each is read and what it cannot deliver, as of the code on main and the live database of 2026-09-30. The contract for writing a reader (a host module or a search provider) is the docstring of plugins/readers/__init__.py, with its types and the declaration check in plugins/readers/_contract.py and the conformance test in tests/test_readers_contract.py, not this file.

The code has two plugins: ats (plugins/ats.py) reads the board of a company someone listed, with one module per host in plugins/readers/; search (plugins/search.py) runs saved queries on sites that list roles across companies. Below, a module of ats is a "host" and a module of search is a "provider". A company's list of roles on a host is its "board"; a board is attached as a target host:slug, e.g. workday:lego.wd103/LEGO_External.

What a reader does is declared in its READS (plugins/readers/_contract.py) and listed per reader on the Sources page. The per-host sections below keep what a declaration cannot say: endpoints, quirks, examples and limits. The shared limits are constants in plugins/readers/_runner.py (MAX_BYTES, TIMEOUTS, DEADLINE, MAX_PAGES, PAGE_DELAY, DETAIL_CAP, SUSPECT_SHARE, MAX_SERIES), app/jobs/pull.py (BATCH_SIZE, STALE_DAYS), app/jobs/reach.py (SMALL) and the fetch_text: block of the config; the table "Rules every source shares" states their effect and is not a second place to change them.

Flow

The order of the stages is CASCADES in app/jobs/cascade.py; this section says what each step leaves behind.

  1. A reader declares what it does (READS) and how to ask and parse (feed_url and parse, or page and rows, and optionally detail and facets).
  2. pull queues batches of 10 targets (app/jobs/pull.py). In each batch ats or search calls _runner.read: it asks the reader for the facets a filter needs, builds the series of requests from the reach, reads the listing whole or in pages, continues or starts a sweep, and applies the 10% guard.
  3. The plugin stores every row with upsert_role and then stamps the target's state (self.state, the state table). A search stamps only ok, complete and ids. Keys are ats:<key>:<target>:
Key Written by Read by
ok _runner.stamp, the run marker, after every row was stored close_boards: a target whose marker is not this run's did not answer
complete stamp close_boards: only a complete read closes
ids stamp, the compound ids the read listed close_boards: closes open roles not in it
filtered stamp, a read by country, place or remote close_boards: keeps roles with a vote or an application
remote_unasked stamp, a filtered read while the agents wanted remote and the host has no remote filter close_boards: keeps remote roles, closes them by age; the Companies line says "remote not asked"
narrowed stamp, a read by fetch terms close_boards: closes only roles not listed for STALE_DAYS
swept stamp, a complete read that finished a sweep begun on an earlier pull close_boards: applies the two-strikes rule
sweep stamp, the cursor of a read cut at MAX_PAGES _runner.read on the next pull
count stamp, the roles the last read listed; reset by Recheck _runner.read, the 10% guard
missing close_boards (_close_swept), the ids the last finished sweep missed the next finished sweep
failing ats._board and run_batch through record_failure, {since, reason}; removed after the next stamp. search:failing:<target> is the same for a search close_boards (21 days), the Companies list and the search row, fetch_text, the guard's escape after 21 days
facets _runner.facets_for, kept one day reach.site_facets, the Companies line
size, sizechecked ats.keep_size: set_board, Recheck, app companies size, or the first read of an unsized board reach.sizes, which decides whether the board is filtered
detailed, detailfailed, detailempty ats.read_board_details (fetch_text): ids read, ids whose read failed, {id: date} of reads that gave no text; the pull drops the ids a complete listing no longer lists fetch_text.plan through detail_due
  1. close_boards, the settle of the pull, closes what a complete read did not list, closes a board or search that failed for STALE_DAYS, releases the run, and raises one pull.settled notice in the Problems log when a target did not answer or was read incomplete, or a board closed more than 50 roles or more than half of its open ones.
  2. Then, in order: prep (maps the hosts' words, resolves places and company aliases, folds copies with app/dupes.py), embed, score (which writes each agent's cut), fetch_text (reads the role pages of the roles in the cut without text), prep, embed and score again for the roles it filled (skipped when it filled none), extract, score, judge, summarise. Extract, judge and summarise are switches under Runs; fetch text is on by default.

The three ways a source is read

Whole board. One request returns every role, with its text for most hosts. The read is complete whenever the answer parses, so the pull can close every role the answer no longer lists.

Paged. The list arrives in pages of a fixed size (READS.page_size), read one after another PAGE_DELAY (0.5 s) apart, at most MAX_PAGES (100) pages a pull. The read is complete when the number of distinct roles read equals the total the host states (complete="stated"), or, for a host that states none, when the read reaches an empty page (complete="end"); a Jobindex search is never complete (complete="never"). A board of more than 100 pages is swept: each pull stores what it read and the next continues from the saved cursor, and the read is complete when a sweep reaches the end. Roles closing between pulls shift an offset-paged host's later roles back past the cursor, so a role of a swept board closes only when two finished sweeps in a row missed it. A host with a ceiling (Workday 2,000) answers nothing past it: a read that reaches it is incomplete, is not swept and closes nothing, so a filter must bring the board under it.

List, then each role. The list, in one request or in pages, carries title, place and mostly a date, but no text (Oracle, Phenom and Jobylon add a teaser). The text is on each role's own page (READS.text="detail"), which the pull does not read. The fetch text stage reads those pages after scoring (app/jobs/fetch_text.py):

  • It takes open roles without text in the cut of an enabled agent (the best by fit and by CV closeness, and the liked and saved, see app/jobs/score.py), best final score first.
  • It reads at most fetch_text.per_board (200) roles per board and fetch_text.per_run (1,000) per run, roles never tried before roles whose read failed, PAGE_DELAY apart, one batch per board on the http pool.
  • A read that gave no text is tried again after fetch_text.retry_days (7). A 404 or 410 counts as read; another failure is retried on a later run; a 429 ends the reads of that board for the run.
  • It runs after every pull, after a saved agent, an affinity change or an override switched, not after a vote, and it can be switched off under Runs.

A role in no agent's cut is never read, so it stays ranked on its teaser or its title. A board of 800 roles does not get all its text; the roles in the cut do. Four consequences follow from the code:

  • embed encodes a role once, from its description, else its teaser, else its title. When better text arrives its vector is dropped and the prep, embed and score that follow fetch text encode it again.
  • A role page may fill only _runner.DETAIL_FIELDS: description, location and places, teaser, remote, country, employment, pay figures and date. Title, link, department and the pay line come from the list, which states them on every pull. A role whose page was read is sent without the list's place and remote on later pulls, so what its page said stays; a place the host changes after that is not picked up.
  • Completeness, and so closing, is decided by the list alone. A board of 800 roles closes its roles from the first pull.
  • SmartRecruiters and Workable list their roles in pages and belong here too, since their list has no text.

Overview

Numbers are from the live database on 2026-09-30, after the pull of 12:52. "Open roles" counts every open role of the host's boards, copies included; the feed's 20,578 leaves copies out, the 24,003 below do not. Since the agents' reach filters big boards at the source (app/jobs/reach.py), a host's count is what is in reach, not what its boards hold: SmartRecruiters read 7,238 roles before the filter and 343 after. "Description" is where the text comes from; for the "list, then each role" hosts it is filled only for roles fetch text has read.

Source Boards Open roles How it is read Roles per request Description Pay Limit that matters most
Greenhouse 87 10,457 whole board all in the list figures a board over 96 MiB loses its text and pay
Ashby 74 4,964 whole board all in the list figures an unknown board name answers an empty board
Workday 17 2,041 list, then each role 20 per role (1,280 read) none 2,000 roles per board; country arrives per role
Lever 26 (25 read) 1,347 whole board all in the list, the intro paragraph only figures text is the opening paragraph
Oracle Recruiting Cloud 5 937 list, then each role 200 per role (603 read), teaser in the list none no pay field
SuccessFactors 14 749 list, then each role the site's own per role (681 read) none default locale only
Teamtailor 38 611 paged 50 in the list none no pay; nine companies without a found site
Jobindex (search) 12 saved (8 on) 562 paged 20 teaser none teaser only; at most 200 results per search; never complete
Platsbanken (search) 6 saved 439 paged 100 in the list none at most 1,000 results per search
Phenom 5 389 list, then each role 100 per role (142 read), teaser in the list none locale spelling known from three sites
SmartRecruiters 11 343 list, then each role 100 per role (1 read) none one country a request; remote is not filtered
Personio 3 320 whole board all in the list figures no country field
Eightfold 3 185 list, then each role 10 per role (158 read) none 10 per request, so 1,000 roles a pull
Recruitee 8 176 whole board all in the list figures an empty board looks like no board to discovery
Workable 8 157 list, then each role 10 per role (1 read) none answers 429 to bursts
Jibe 1 137 paged 100 in the list none Booking Holdings' roles read with Booking.com's
Deel 1 96 whole board all in the list line only pay has no period
Gem 2 45 list, then each role all per role (44 read) none undocumented query, can break
Jobylon 2 33 list, then each role all per role (33 read), teaser in the list none scraped from the careers widget
HR Manager 1 7 paged 100 in the list none the portal's robots.txt disallows reading; the owner has not decided
Rippling 1 2 list, then each role all per role figures text, date and pay cost one request per role
Pinpoint 1 2 whole board all in the list figures no date
HiBob 1 2 whole board all in the list figures pay never seen filled
BambooHR 1 2 list, then each role all per role none paging of a large board unverified
Adzuna (search) 0 0 paged 50 teaser figures never run live; needs a key
freehire (search) 0 0 paged 100 in the list figures 10,000 results per search; the query is noisy
Jobnet (search) 0 0 paged 100 in the list none 10,000 results per search; needs the header x-csrf: 1
Akademikernes Jobbank (search) 0 0 paged 100 per role none not sorted by date, and no total, so never complete

"Figures" means yearly salary_min, salary_max and currency, plus a pay line; "line only" means a pay line (salary_text) and no figures. Figures are yearly: a monthly figure is multiplied by 12 where the host states the period, and an hourly, daily or weekly one is kept as a line only.

Rules every source shares

Limit Value What it means
Schedule pull every 6 h by default, editable under Runs Each pull starts the cascade in "Flow". Extract and summarise are off in the config and switched under Runs (both are on in the live database); fetch text is on by default.
Batches 10 boards or searches per batch, 8 batches at once (workers.http: 8) Within a batch boards are read one after another. Enrich reads one batch per board on the same pool. One pull runs at a time.
Where requests go https on port 443, only to the host names the host module allows; no IP address, no local name; at most 3 redirects, each checked A slug cannot point a request anywhere else.
Size cap 96 MiB per response A larger answer fails the board. Greenhouse retries once without text and pay; no other host has a fallback.
Time limits 10 s to connect, 30 s between bytes, 60 s for the whole request The same for boards, role pages and searches. A slow board fails for this pull and is asked again next pull.
Pages per board 100 a pull A board above it is swept across pulls: each pull stores what it read and the next continues from the cursor. A role of a swept board closes only when two finished sweeps in a row missed it, so a new role on a later page waits up to one sweep. A read that reaches the host's ceiling (Workday 2,000) is not swept and closes nothing; a filter must bring the board under it.
Wait 0.5 s before every page after the first, for boards and searches alike, and before every role page The list of a Workday board of 1,000 roles spends about 25 s waiting.
Per-role reads fetch_text, after scoring: 200 per board and 1,000 per run, the roles in the agents' cut See "List, then each role". Roles in no cut are not read.
Closing a role after a complete read, every open role of the board it did not list An incomplete read closes nothing, and so does a read that asked nothing. A role listed again reopens. A board switched off closes its roles at once. A filtered read keeps roles with a vote or an application, and remote roles when the host could not be asked for remote; a read by fetch terms closes only roles not listed for 21 days.
Search roles a complete search closes what it did not list; otherwise a role closes when no search has listed it for 21 days A search result is never a company's whole list. A Jobindex search is never complete, so its roles close by the 21 days only. A search failing for 21 days closes its roles.
A board that fails first failure: logged, roles stay open, the Companies list shows "not answering since" Any error counts: refused host, timeout, HTTP error, parse error, oversize, a row that would not store, and a read that lists under 10% of what the same read listed last time (SUSPECT_SHARE) once that was at least SUSPECT_MIN, 10. A search that fails is recorded the same way and its row says so.
A board that fails for 21 days all its open roles close at the next pull, and a suspect answer that has stood that long is accepted The next answer reopens what it lists. STALE_DAYS is the one 21.
robots.txt not read at run time Decided per reader when it is built and recorded in READS.robots with the date (docs/decisions.md). Crawl-delay is not honoured.
429 first page: the board fails; a later page: the read stops, keeps what it read and is incomplete; a role page: the reads of that board stop until the next fetch text run Nothing is closed on a list cut short by a 429.

How far a board is read: a pull asks each board of 300 roles or more for the reach of the search agents that are switched on (app/jobs/reach.py): the union of their any gates on country, town (as its country) and remote, or every role when one agent can take a role from anywhere. A company set to All countries is asked for the agents' wide reach, the union of their require reach, Europe today; a host that asks one country a request reads such a board whole instead of once per country (33 codes today), unless fetch terms narrow it. A board's own reach, set on the Companies list, wins. A complete filtered read closes the roles outside the reach, except those with a vote or an application. A board's size is set once, when it is added, on Recheck or by app companies size, and a pull does not rewrite it; a board with no size yet is sized first in its batch and then read as its size says, and a board whose reader cannot narrow the reach is read whole and sized by that read. A host that cannot filter a dimension ignores it: SmartRecruiters, Phenom, SuccessFactors and Eightfold have no remote filter, so their reach asks for countries only.

Fetch terms narrow a wide read by words. Each agent has a list of them (fetch_terms, set in the agent editor); the terms of a pull are the union over the agents that are on, and none when one of those agents has none. They go only to a board read with the wide reach: a company set to All countries, or a board whose reach is more countries than a one-country host is asked for (MAX_SERIES, 8). The narrow reach (Denmark, Sweden) leaves at most about 150 roles on any big board, so it takes no terms, and nor does a board under 300 roles or one with its own reach. A company set to All roles takes none on any of its boards. A host that takes a keyword gets one series per term, unioned by id, each combined with the country series; the survey shows that as an AND on SmartRecruiters, Eightfold, SuccessFactors, Phenom and Workday. When terms times the country series exceed 8, the place part of the reach goes first, whole, and the terms stay; more than 8 terms read the board unfiltered. The survey found the keyword matching the ad text and not only the title where it could tell, and could not tell on SuccessFactors, Workday, Workable and Jibe (docs/filter-survey.md), so a term like engineer cuts less than it looks. A read with terms is never the whole board: it records no size, closes no role it did not list, and the 10% guard holds it only to a read with the same terms and places. The search providers take no terms: each saved search has its own query.

What no source does:

  • Filter on the host's side for a host other than SmartRecruiters, SuccessFactors, Workday, Oracle, Phenom and Eightfold. Greenhouse, Ashby, Recruitee and the rest are read whole. The search providers filter by their own query, place and country.
  • Filter by category or level at the source. Workday, Oracle, Jibe and Eightfold state category ids, but nothing maps an agent's terms to them yet (docs/filter-survey.md).
  • Read more than one board per company. DFDS is read from its Danish Teamtailor board only.
  • Use a key taken from a site's script. Maersk, New Work and Welcome to the Jungle are on the Watchlist for that reason.
  • Read a page that needs a browser to run its script.
  • Log in anywhere.

Hosts read as a whole board

Greenhouse

Target the board token, e.g. greenhouse:trustpilot
Companies 87 boards: Trustpilot, Cognite, Wolt
List boards-api.greenhouse.io/v1/boards/<token>/jobs with content=true and pay_transparency=true, the whole board in one answer; no total
Requests per pull 1; 2 when the first answer is over 96 MiB
Description in the list, full text (content)
Date first_published, else updated_at, which the host moves on an edit; trusted as the posting date
Place and country every offices entry; location.name when the role has no office or the name says more, with placeholder names such as "Hybrid" dropped. The host states no country; it is resolved from the places
Remote none from the host; prep reads remote, hybrid or onsite from the place words
Pay figures from pay_input_ranges when there is exactly one range; a range whose title says hour or day is a line only; any other range is taken as yearly. Several ranges give one line per range and no figures
Found by discovery yes, from a link to boards.greenhouse.io, job-boards.greenhouse.io or the embed script; a guessed name is probed first of all hosts
Limitations Over 96 MiB the board is read again without content=true: titles land, text and pay of the whole board are lost. An eu.greenhouse.io link is read from the main API. The pay flag must be sent, or no range comes back.

Lever

Target the site name, or eu/<site> on Lever's EU instance, e.g. lever:spotify, lever:eu/tomtom
Companies 26 boards, one switched off: Spotify, TomTom, Pipedrive
List api.lever.co/v0/postings/<site>?mode=json (api.eu.lever.co for eu/), the whole board in one answer; no total, no paging parameter sent
Requests per pull 1
Description in the list, description (else descriptionPlain); the module reads no lists or additional sections, so it is the opening text
Date createdAt; trusted
Place and country categories.location and every allLocations entry; the host's country is handed on when the role has one place, otherwise the country is resolved from the places
Remote workplaceType, the host's own word
Employment categories.commitment, the host's own word
Pay figures from salaryRange for per-year-salary and per-month-salary (x12); other intervals a line only
Found by discovery yes, from a jobs.lever.co or api.lever.co link on either instance; a guessed name is probed on the US instance, then on the EU one
Limitations The same site name on the two instances is two companies. Only the opening text of an ad is read (docs/open.md).

Ashby

Target the board name, which may carry a dot or be a uuid, e.g. ashby:pleo, ashby:jimdo.com
Companies 74 boards: Pleo, Too Good To Go, Lovable
List api.ashbyhq.com/posting-api/job-board/<name>?includeCompensation=true, the whole board in one answer; no total
Requests per pull 1
Description in the list, full text (descriptionHtml)
Date publishedAt; trusted
Place and country the primary location and every secondaryLocations entry; country resolved from the places
Remote workplaceType (Remote, Hybrid, OnSite) as the host words, else isRemote, which is true for hybrid roles too
Employment employmentType, the host's own word
Pay figures from the first Salary component with interval 1 YEAR or 1 MONTH (x12); an hourly one a line only; bonus and equity appear in the line only; when no component states a bound the line falls back to compensationTierSummary or scrapeableCompensationSalarySummary
Found by discovery yes, from a jobs.ashbyhq.com link; a guessed name is probed
Limitations The pay flag must be sent, or no compensation comes back. An unknown board name answers an empty board, so a board with no open roles looks like no board to discovery. READS.empty="suspect" keeps a known board from closing its roles on such an answer; a mistyped name attached as a new board still reads as an empty, complete board (docs/open.md).

Recruitee

Target the subdomain, e.g. recruitee:bunq
Companies 8 boards: bunq, idealo, Climeworks
List https://<sub>.recruitee.com/api/offers/, the whole board in one answer; no total
Requests per pull 1
Description in the list, description only (requirements is not read)
Date published_at, else created_at; trusted
Place and country every locations entry as "city, state, country"; location or city when there are none; a remote offer with no place gets the place "Remote"
Remote remote, true or false
Seniority, employment experience_code and employment_type_code, the host's own words
Pay figures from salary for period year and month (x12); other periods a line only
Found by discovery yes, from a <sub>.recruitee.com link; a guessed name is probed
Limitations A board with no offers answers an empty list and looks like no board to discovery. A board on the company's own domain is not read (planned in wave 2, Quantum Systems).

Personio

Target the subdomain, e.g. personio:penneo
Companies 3 boards: Penneo, tado, 1KOMMA5°
List the XML feed https://<sub>.jobs.personio.de/xml, the whole board in one answer; no total
Requests per pull 1
Description in the list, every jobDescription value joined
Date createdAt; trusted
Place and country office and every additionalOffices office; the feed has no country field, so it is resolved from the places
Remote none for the role; a place whose text contains "remote" is a remote place, and prep makes the role remote if any place is
Seniority, employment the host's seniority and its contract (or schedule) words
Pay figures from salaryInformation for yearly and monthly (x12); hourly, daily, weekly a line only; rare
Found by discovery yes, from a jobs.personio.de or jobs.personio.com link; a guessed name is probed
Limitations The feed has no role link; it is built as /job/<id>. Only the feed's default language is read. The company Personio itself is on the Watchlist as blocked.

Pinpoint

Target the subdomain, e.g. pinpoint:xeneta
Companies 1 board: Xeneta
List https://<sub>.pinpointhq.com/postings.json, the whole board in one answer; no total, no paging keys
Requests per pull 1
Description in the list, full text: description, responsibilities, skills and benefits sections
Date none: the list states none and the role page is not read for it; the role counts as posted when first seen
Place and country location.name (else city) plus province, one place; country resolved from that line
Remote workplace_type: onsite, hybrid, remote
Employment employment_type, the host's own word
Pay figures when compensation_visible, for annual and monthly (x12) frequencies; others a line only. The frequency spellings are guessed, since no board read so far shows pay
Found by discovery yes, from a <sub>.pinpointhq.com link; not probed
Limitations Written from Xeneta's board, two roles. Whether a large board pages /postings.json is unverified. A board shared by several brands (inMusic with Native Instruments) is read whole, with no filter on division.

Deel

Target the board slug on jobs.deel.com, with case, e.g. deel:klarna
Companies 1 board: Klarna
List the HTML page https://jobs.deel.com/<slug>, from which the Next.js server payload is read; the whole board in one answer; no total
Requests per pull 1
Description in the list, full text (richtextDescription)
Date the publication's createdAt, else the posting's; not trusted, so the role counts as posted when first seen
Place and country every jobLocations name as a place, repeated names dropped, each carrying the role's remote flag; country resolved from the places
Remote workArrangementEnum: ON_SITE, HYBRID, REMOTE
Employment the first jobEmploymentTypes name
Pay line only, when visible: currency and two amounts with no period, so no yearly figure can be told from a monthly one
Found by discovery yes, from a jobs.deel.com link, case kept; not probed
Limitations Deel's /api/ is disallowed by robots.txt, so the board is read out of the page's React payload, which a Next.js release can change. Written from Klarna's board only. A wrongly cased slug answers Job Board Not Found and fails the board.

HiBob

Target the subdomain of careers.hibob.com, e.g. hibob:dixa
Companies 1 board: Dixa
List https://<sub>.careers.hibob.com/api/job-ad with the header companyIdentifier: <sub>, the whole board in one answer; no total. Declared as paged with complete="end" because page may send headers; it reads one page
Requests per pull 1
Description in the list, full text: description, responsibilities, requirements, benefits
Date publishedAt; not trusted, so the role counts as posted when first seen
Place and country site plus country. A company that hires at two sites posts one ad per site with its own id (places="copies"); app/dupes.py folds them into one role
Remote workspaceTypeId: remote, hybrid, onsite
Employment employmentType, the host's own word
Pay figures from the payTransparency* fields for year and month (x12); hour, day and week a line only. No board seen had them filled, so the period spellings are guessed
Found by discovery yes, from a <sub>.careers.hibob.com link; not probed
Limitations Written from two boards (Dixa, Liquidia). The header is the public subdomain, not a key; without it the API answers 401.

Hosts read in pages

Teamtailor

Target the subdomain of teamtailor.com, or the whole host of a career site on the company's domain, e.g. teamtailor:lunar, teamtailor:careers.trackunit.com
Companies 38 boards: Lunar, Trackunit, DFDS
List the RSS feed https://<site>/jobs.rss, 50 per request by offset; no total, so the read goes on to an empty page
Requests per pull roles / 50, rounded up, plus 1 for the empty page; the largest board attached has 75 roles, so 3
Description in the list, full text
Date pubDate; trusted
Place and country every tt:location as a place "city, country", each remote when remoteStatus says so; country resolved from the places
Remote remoteStatus, handed on as the host's word: fully is remote, hybrid, onsite; none and temporary stay unknown
Pay none: the feed states no pay
Found by discovery yes, from a <sub>.teamtailor.com link; a page that loads Teamtailor's CDN names the page's own host as the board; a guessed name is probed
Limitations A board of more than 100 pages is swept across pulls and completes on the empty page. A page with nothing new ends the read incomplete. Nine seed companies have no board because their careers link is a marketing site, not the career host.

Jibe

Target the career site's host, e.g. jibe:jobs.booking.com
Companies 1 board: Booking.com
List https://<host>/api/jobs?limit=100&page=<n>, 100 per request, the most the host serves; states totalCount
Requests per pull roles / 100, rounded up; 2 for Booking.com
Description in the list, full text: description and qualifications
Date posted_date; not trusted, so the role counts as posted when first seen
Place and country full_location split at ";" into places; the host's country_code is handed on when the role has one place
Remote none (location_type is a kind of coordinates)
Employment employment_type, the host's own word
Pay none: the salary_* fields were 0 on every role and carry no currency
Found by discovery no slug: a link to Jibe's CDN names the host only; the target is set by hand
Limitations Only Booking.com's site was read. No brand filter: the Booking Holdings roles are read with the Booking.com ones. The site's robots.txt asks for Crawl-delay: 5, which is not honoured.

HR Manager

Target the portal's customer name, e.g. hrmanager:teknologisk
Companies 1 board: Danish Technological Institute (hrmanager:teknologisk, 7 open roles). Seaborg, the one seed company on the portal, is unattached and on the Watchlist as robots
List the RSS feed api.hr-manager.net/JobPortal.svc/<customer>/PositionList/rss/?incads=true, 100 per request by skip; no total, so the read goes on to an empty page
Requests per pull roles / 100, rounded up, plus 1 for the empty page
Description in the list, the whole advertisement
Date pubDate; not trusted
Place and country none: the feed names no place
Remote none
Pay none
Found by discovery yes, from a portal or API link; not probed
Limitations The portal's robots.txt on candidate.hr-manager.net disallows everything but the application form; the feed's API host has no robots.txt. READS.robots says "owner to decide", and the board of the Danish Technological Institute is attached all the same (docs/open.md). Without take the host answers 25 roles.

Hosts read as list, then each role

For every host below the pull reads the list only; the description arrives when fetch text reads the role's page, so "Requests per pull" counts list requests. "Places" are a list of the places the host states; only the location line joins them.

SmartRecruiters

Target the company identifier, e.g. smartrecruiters:BoschGroup
Companies 11 boards: Bosch (about 4,800 roles on the site, 13 open in reach), Delivery Hero, Wise
List api.smartrecruiters.com/v1/companies/<id>/postings, 100 per request by offset; states totalFound
Requests per pull one series per country of the reach (two for Bosch: DK and SE), each roles / 100, rounded up; a board read whole is roles / 100
Description per role, GET /v1/companies/<id>/postings/<id>: the jobAd.sections jobDescription, qualifications and additionalInformation, joined; companyDescription is the same blurb on every role and is left out. Read by fetch text for the roles in the cut only: 1 of 343 open roles has text
Date releasedDate; trusted
Place and country fullLocation, else city and country, with empty parts removed; the host's country is handed on
Remote location.remote, true or false, as the host's word
Seniority, employment experienceLevel and typeOfEmployment, the host's ids
Pay none: the list states no pay
Found by discovery yes, from a jobs., careers. or api.smartrecruiters.com link; a guessed name is probed
Filter at the source ?country=dk, one country a request; remote is ignored by the API, so a remote role outside the reach is not read. Bosch DK: 2 of 4,830 (2026-09-30). Which countries is the agents' reach, see above. Fetch terms as ?q=engineer, one a request, AND with the country; it matches title and text (Bosch: 1,713 of 4,830)
Limitations 100 pages a pull; a larger board is swept across pulls. Whether the identifier is case-sensitive is unsettled: the module docstring says it is, docs/decisions.md says it is not (docs/open.md). An unknown identifier answers an empty list, not an error: READS.empty="suspect" keeps a known board from closing its roles on it, but a mistyped slug attached as a new board reads as an empty, complete board.

The reader's "Fetch the posting" button shows for a role with no article_text and a description under 500 characters, so for these roles until fetch text has read their page. It reads one posting page on demand into article_text, which summarise reads and embed and extract do not. Whether it reads a SmartRecruiters page cleanly was not checked.

Workable

Target the account name, e.g. workable:huggingface
Companies 8 boards: Hugging Face, Kahoot!, Starling Bank
List a POST to apply.workable.com/api/v3/accounts/<account>/jobs, 10 per request with a nextPage token; states total
Requests per pull roles / 10, rounded up, 0.5 s apart; the largest board has 50 roles, so 5
Description per role, GET /api/v2/accounts/<account>/jobs/<shortcode>: description, requirements and benefits, joined. The row keeps the shortcode, since source_id is the numeric id. Read by fetch text for the roles in the cut only: 1 of 157 open roles has text
Date published; trusted
Place and country every locations entry as "city, region, country", each remote when the role is; location when there are none
Remote workplace (remote, hybrid, on_site) as the host's word, else the remote flag
Employment type, the host's own word
Pay none: the list states no pay
Found by discovery yes, from an apply.workable.com or <account>.workable.com link; not probed, since a run of guesses trips Workable's rate limit
Limitations 100 pages of 10 a pull; a larger board is swept across pulls. Workable answers bursts with 429, which is why pages and role reads are 0.5 s apart; a 429 after the first page ends the read incomplete. The role link is built from the shortcode.

SuccessFactors

Target the career site's host, or host plus a brand path, e.g. successfactors:careers.vestas.com, successfactors:jobs.teradyne.com/MiR
Companies 14 boards: Novo Nordisk, Vestas, Carlsberg
List the site's HTML search page /search/?startrow=<n>, parsed in its two known layouts; page size is the site's own (10, 15, 25 or 100) and cannot be set; a total where the pagination label states one
Requests per pull roles / the site's page size, rounded up
Description per role, the itemprop="description" block of the role page
Date the list's date column where it parses; the role page's datePosted replaces it when earlier; trusted
Place and country the list's location, with a two-letter country code turned into the name; the role page's microdata replaces it
Remote none from the host
Pay none
Found by discovery yes, from a link to a role, /go/ page or search on the site's own host; a link to the SAP back end names the host only; not probed. A site on the company's own domain whose pages link only the back end is set by hand
Filter at the source optionsFacetsDD_country=DK, one country a request; no remote facet. Vestas DK: 64 of 668 (2026-09-30). Which countries is the agents' reach, see above. Fetch terms as the form's q=engineer, one a request, AND with the country (Vestas DK: 40 of 64)
Limitations Only the default locale's roles are listed: a role that exists only in another locale (Carlsberg's French brand, 37 of 105) is not read. Only /search/ and /job/ are read, never /services/ or the successfactors.eu back end, so a company with only the back end (Bang & Olufsen) cannot be read. 100 pages a pull; a larger site is swept across pulls. A third layout or a bot wall that answers 200 fails the board with "not a SuccessFactors search page". Read from this machine only; not yet from the deployed server.

Workday

Target <tenant>.<wdN>/<Site>, site with case, e.g. workday:lego.wd103/LEGO_External
Companies 17 boards: LEGO Group, Zendesk, Equinor, and since 2026-09-30 Criteo, Darktrace, Novonesis and NVIDIA
List a POST to /wday/cxs/<tenant>/<Site>/jobs, 20 per request by offset (21 or more answers 400); the first page states the total
Requests per pull roles / 20, rounded up; 50 for a board of 1,000 roles
Description per role, jobDescription from the role's JSON
Date the list's "Posted N Days Ago" as a day, possibly one day off; "Posted 30+ Days Ago" and other languages give none; the role's startDate replaces it; trusted
Place and country the list has locationsText ("Copenhagen" or "2 Locations"); the per-role read adds every location and the country, so the country arrives with the role page
Remote remoteType, where the tenant sends it, as the tenant's own word ("Remote", "Hybrid", "Full Remote", "No"); prep maps it
Employment timeType, the host's own word
Pay none: no pay field; pay appears only inside the text
Found by discovery yes, from a myworkdayjobs.com link with a site; not probed
Filter at the source the tenant's own facets in appliedFacets, ids read by facets once a day: the facet whose values are countries, and any value that reads as remote. Two facets intersect, so remote is a series of its own. LEGO DK: 97 of 455 (2026-09-30). A tenant with no country facet is read whole. Which countries is the agents' reach, see above. Fetch terms as searchText in the body, one a request, AND with the facets (LEGO: 106 for engineer)
Limitations 2,000 roles per board (100 pages of 20), the ceiling. A tenant has several sites and each is its own board. Every tenant is behind Cloudflare and was read from this machine only. The slug's case is kept (KEEP_CASE).

Oracle Recruiting Cloud

Target <pod host>/<siteNumber>, e.g. oracle:fa-evmr-saasfaprod1.fa.ocs.oraclecloud.com/CX_1
Companies 5 boards: Danske Bank, Nokia, Milestone Systems, Sinch, Pioneer Centre for AI
List the REST resource recruitingCEJobRequisitions, 200 per request by offset, with secondary places expanded; states TotalJobsCount
Requests per pull roles / 200, rounded up; 3 for Nokia's roughly 600
Description per role: external description, responsibilities and qualifications joined. The list's one-paragraph ShortDescriptionStr is stored as the teaser (READS.teaser=True), which is shown and embedded until the description arrives
Date PostedDate; the role's ExternalPostedStartDate replaces it when earlier; trusted
Place and country the primary place plus every secondary one, each a place of the role
Remote WorkplaceTypeCode as the host's word (e.g. ORA_HYBRID); prep maps it
Pay none: the resource states no pay
Found by discovery yes, from a candidate site or role link on the pod, or a REST call naming siteNumber; not probed
Filter at the source selectedLocationsFacet with the pod's geography ids, and selectedWorkplaceTypesFacet=ORA_REMOTE as a series of its own. locationsFacet lists the ten biggest countries only, so a country missing from a full list is read unfiltered: fa-evmr (Nokia) has neither DK nor SE listed and is read whole. Which countries is the agents' reach, see above. Fetch terms as keyword= in the finder, one a request; it matches the text (Nokia: 468 of 554 for engineer)
Limitations The host is the tenant's Fusion pod, not the company's domain (jobs.nokia.com redirects to it). Links are built for locale en. The department fields were empty on every role of the first four boards; Pioneer's were not checked.

Phenom

Target the career site's host plus its locale root, e.g. phenom:www.careers.philips.com/global/en
Companies 5 boards: King, Just Eat Takeaway.com, Philips, BCG, Verisure
List a POST to https://<host>/widgets, 100 per request by offset; states totalHits
Requests per pull roles / 100, rounded up; 9 for Philips' roughly 880
Description per role, the JSON-LD JobPosting description of the role page. The list's descriptionTeaser is stored as the teaser (READS.teaser=True)
Date the list's dateCreated, else postedDate, which the site moves on a refresh; the role page's datePosted replaces it when earlier; trusted
Place and country every place of multi_location, each a place of the role
Remote per role only, from the page's checkRemote
Pay none
Found by discovery yes, from a /<country>/<lang>/search-results link; a link to Phenom itself names the host only; not probed
Filter at the source selected_fields.country, a list of English names in one request; no remote. Philips NL and DE: 111 of 873 (2026-09-30). Which countries is the agents' reach, see above. Fetch terms as keywords in the body, one a request, AND with the countries; it matches the text, not the title
Limitations The locale is built as <lang>_<country>, the spelling of the three sites first read; another site may spell it differently. 100 pages a pull; a larger board is swept across pulls. A role page without a description fails the read and is retried on a later run.

Eightfold

Target <tenant host>/<company domain>, e.g. eightfold:jobs.ericsson.com/ericsson.com
Companies 3 boards: Ericsson, Microsoft, Infineon
List https://<host>/api/pcsx/search?domain=<domain>&sort_by=timestamp, newest first, 10 per request whatever num asks; states count
Requests per pull roles / 10, rounded up, at most 100
Description per role, jobDescription from position_details
Date creationTs, else postedTs, which the host refreshes in bulk; not trusted, so the role counts as posted when first seen
Place and country every location, repeated names dropped, each a place of the role
Remote workLocationOption: onsite, hybrid, remote
Pay none
Found by discovery yes, from an eightfold.ai link that carries domain=; a bare eightfold.ai link names the host only; not probed
Filter at the source location=<country name>, one country a request; no remote. Ericsson SE: 154 of 618 (2026-09-30). Which countries is the agents' reach, see above. Fetch terms as query=, one a request, AND with the location; it matches title, text and skills (Ericsson SE: 102 of 154 for software)
Limitations With 10 per request and 100 pages a pull, a board over 1,000 roles is swept across pulls; what the host answers past offset 1,000 was not checked. The country filter brings big boards under the cap: Microsoft (size 2,345) has 29 open roles in reach, and Infineon (999 stored) has none in DK and SE. Verified on three tenants only.

Gem

Target the board name on jobs.gem.com, with case, e.g. gem:productboard
Companies 2 boards: sennder, Productboard
List a GraphQL POST to jobs.gem.com/api/public/graphql, the whole board in one answer; no total. Declared as paged with complete="end"; it reads one page
Requests per pull 1
Description per role, descriptionHtml, one GraphQL POST per role
Date per role only, firstPublishedTsSec; not trusted, so the role counts as posted when first seen
Place and country every location as a place (the city, else the location name); isoCountry is fetched and not used
Remote locationType: onsite, hybrid, remote
Employment employmentType, the host's own word
Pay none; compensationHtml is fetched but was null on every role read
Found by discovery yes, from a jobs.gem.com link, case kept; not probed
Limitations The GraphQL queries were read out of the page's script bundle and are undocumented; a new bundle from Gem can rename a field and fail the board. An unknown board answers an empty list, not an error: READS.empty="suspect" protects a known board, a mistyped name attached as a new board reads as an empty, complete board.

Jobylon

Target the numeric company id, e.g. jobylon:3143
Companies 2 boards: Einride, Vipps MobilePay
List the careers widget's embed page cdn.jobylon.com/jobs/companies/<id>/embed/v2/, whose script literal holds the whole board; no total. The list carries a summary, stored as the teaser
Requests per pull 1
Description per role, the JSON-LD description of the role page on emp.jobylon.com
Date the list's day ("Sept. 25, 2026"); the role page's datePosted replaces it when earlier; trusted
Place and country the list's place names, which can be cut short ("Houston +3 more"); the per-role read fills every place
Remote workspace: remote, hybrid, onsite
Seniority, employment experience and employment_type, the host's own words
Pay none; JSON-LD pay is not read
Found by discovery yes, from an emp. or cdn.jobylon.com link or a jbl_company_id on the company's own site; not probed
Limitations Jobylon's own feeds are addressed by a uuid the company holds, so the widget is scraped; a change to its script literal breaks the board. An unknown id answers 404 and fails the board.

Rippling

Target the board slug on ats.rippling.com, with case, e.g. rippling:prisma-careers
Companies 1 board: Prisma
List api.rippling.com/platform/api/ats/v1/board/<slug>/jobs, the whole board in one array, one entry per role and place, merged by role; no total
Requests per pull 1
Description per role, description.role, one role record per role
Date per role only, createdOn; trusted
Place and country the list's place labels as places; the per-role read replaces them with every work location
Remote the reader sets no role-level remote; a place whose label starts with "remote" is a remote place, and prep makes the role remote if any place is
Employment employmentType.label, the host's own word
Pay figures, per role only, when the record has exactly one pay range with YEAR or MONTH (x12) frequency; no pay line
Found by discovery yes, from an ats.rippling.com or API link, case kept; not probed
Limitations Text, date and pay each wait for the role page. Several pay zones give no figures. A wrongly cased slug answers Job Board not found and fails the board.

BambooHR

Target the subdomain, e.g. bamboohr:configit
Companies 1 board: Configit
List https://<sub>.bamboohr.com/careers/list, the whole board in one answer; a list shorter than its totalCount fails the board rather than being read as whole
Requests per pull 1
Description per role, /careers/<id>/detail
Date per role only, datePosted; trusted
Place and country the list's city and state as one place; the country arrives with the role page
Remote isRemote, else locationType 0 onsite, 1 remote, 2 hybrid; the codes are assumed from Configit's board
Employment employmentStatusLabel, the host's own word
Pay none; the per-role compensation was null
Found by discovery yes, from a <sub>.bamboohr.com link; not probed
Limitations Written from one board of two roles. Whether a large board pages /careers/list is unverified.

The search providers

A saved search is a query with its parameters, stored as a search subscription provider:name. It reads up to 5 pages by default and at most 10. A search that finds nothing is not saved. A provider that sends only an excerpt (Jobindex, Adzuna) stores it as the role's teaser, and a provider that sends the text (Platsbanken, freehire, Jobnet) stores it as the description; embed and extract read the description, else the teaser. The reader shows "Fetch the posting" for any role with no article_text and a description under 500 characters; it fetches the posting page once, on demand, into article_text, which the reader and summarise use and embed and extract do not. For a Jobindex role the fetch follows the "Se jobbet" link of Jobindex's page to the posting itself, keeps the link as roles.posting_url and falls back to Jobindex's own text (app/jobs/posting.py). A search that fails is skipped for the pull and leaves no record. No provider reads robots.txt at run time; the decisions for Jobindex (which is read although its robots.txt disallows sort=, page= and geoareaid=) and Adzuna (whose API host disallows / for every agent) are in READS.robots and docs/decisions.md.

Jobindex

Saved search q in Jobindex's syntax (words are OR, "a b" a phrase, +word required) and optionally area, Jobindex's region id (1 Region Hovedstaden, 8 Aarhus, ...)
List the RSS twin of the search page, jobindex.dk/jobsoegning.rss, newest first, 20 per page; no total. READS.complete="never": a search is never complete, so its roles close by the 21 days only
Pages read 5 by default (100 results), 10 at most (200)
Text an excerpt of a couple of hundred characters from the feed, stored as the teaser; 561 of 562 open roles have some text. The full text only through "Fetch the posting", on demand, since every fetch of Jobindex's link counts as a click in its statistics
Date pubDate; trusted
Place the item's area, else the search's area; country always Denmark
Remote the reader states none; prep reads place and title words
Pay none
Key none
Limitations The company is the logo's alt text or what follows the title's last comma. Items are not followed to the employer's site during a search; the on-demand fetch follows the "Se jobbet" link.

Platsbanken

Saved search q and optionally region, a län id from JobTech's taxonomy (Skåne is CaRE_1nn_cSU); empty for all of Sweden
List jobsearch.api.jobtechdev.se/search, newest first, 100 per page; states total
Pages read 5 by default (500 results), 10 at most (1,000); the API refuses an offset above 2,000, which the page limit never reaches
Text description.text of the ad, the whole ad
Date publication_date; trusted
Place every entry of workplace_addresses (municipality, else region, else country) as a place of the role; country always Sweden
Remote workplace_model.label where present, which is mostly empty; prep also reads headline words
Pay none
Key none
Limitations A region is a län; there is no municipality or city filter. Free text ranks by all words rather than requiring them; a quoted phrase narrows it.

Adzuna

Saved search q, country (gb, de, nl, fr, at, be, es, it, pl, ch; not Denmark) and optionally where, a free place text
List api.adzuna.com/v1/api/jobs/<country>/search/<page>, newest first, 50 per page; states count
Pages read 5 by default (250 results), 10 at most (500)
Text Adzuna's description snippet, stored as the teaser; its length is not stated in the code
Date created; trusted
Place location.display_name; country from the search
Remote prep reads the place line, then title words
Pay figures from salary_min and salary_max in the country's currency, dropped when Adzuna marks them as predicted
Key a free key from developer.adzuna.com, as sources.search.adzuna in the config or ADZUNA_APP_ID and ADZUNA_APP_KEY; without one the search fails
Limitations Built against Adzuna's documented response and never run live; no Adzuna role is in the database.

freehire

Saved search q, optionally country (lower-case ISO codes, comma-separated; empty for all) and remote (a work mode of freehire's: MODES in the module)
List freehire.me/api/v1/agent/jobs/search, newest first, 100 per page; states meta.total. A public API with no key, 300 requests a minute; robots.txt allows / and invites API use with a descriptive user agent
Pages read 5 by default (500 results), 10 at most (1,000); the API ends at offset + limit = 10000
Text the whole text, as HTML in the answer
Date posted_at; trusted
Place cities and location; the country only when the row names exactly one
Remote work_mode
Pay figures from enrichment, only where salary_period is a year
Key none
Limitations freehire aggregates about 50 hosts, and keeps the one a row came from in raw (source: greenhouse, jobnet, ...). A row whose employer is a board roledesk reads is a copy of that board's role and is hidden behind it by the dupes rule. Unquoted words in q are OR over title, company, text and place, so a query is noisy: narrow it by country.

Jobnet

Saved search q and optionally region, one of Jobnet's five region ids (REGIONS in the module); empty for all of Denmark
List jobnet.dk/bff/FindJob/Search, newest first, 100 per page; states totalJobAdCount. The site's own backend answers 401 without the header x-csrf: 1 and 200 with it, with no login; this supersedes the earlier note that its search answers 401 outside its own session
Pages read 5 by default (500 results), 10 at most (1,000); page 101 at 100 a page answers empty
Text the whole text, as HTML in the answer
Date publicationDate; trusted
Place postalDistrictName, else municipality; country Denmark unless the ad names another
Remote none
Pay none
Key none
Limitations The state's portal: mostly the public sector and small companies, and about a fifth of its ads link to an employer's own ATS. Every word must appear and quotes find nothing, so a search is one term. There is no robots.txt (/robots.txt redirects to a login). The ad's deadline is kept in raw only.

Akademikernes Jobbank

Saved search q and optionally region (an amt id from the site's own search form: REGIONS in the module, 2 is Storkøbenhavn) and remote (helt fully remote, delvist partly)
List the RSS feed jobbank.dk/job/rss/, 100 items a page; an empty page ends it. It states no total and is not sorted by date
Pages read at most the module's ceiling, which keeps a run under about 20 pages
Text one request a role: the JSON-LD JobPosting on /job/<id>/..., read by fetch text for the roles in the cut. The listing carries none
Date datePosted from the role's page; trusted
Place the region in the item's description line, and jobLocation.addressLocality from the page; country Denmark
Remote not stated by a row; the search's remote filter narrows the list
Pay none
Key none
Limitations Academic and research roles, plus some corporate ads. robots.txt allows /job/ and disallows /fwd/webjob/, which is never followed. Cloudflare may answer a challenge instead of the page, which is an error for that role and not an empty text.

Jooble was left out: it gives a key only on a manual application and answered a Cloudflare challenge. Jobdanmark was left out too: about a quarter of its newest ads are on Jobnet, freehire carries the rest as source jobdanmark, and its list has no text. LinkedIn's guest pages are out because its robots.txt disallows / and its terms forbid automated access; LinkedIn enters only as alert mail. Indeed has no public search API.

Sources that cannot be read, and why

The table is the seed's: 76 of the 362 companies in seed/companies.json have no board there and carry a careers link the survey opened on 2026-09-29. The live database has moved on, and its Watchlist tab and app companies by-hand are the current list. Since the seed was written, Infineon and Microsoft (Eightfold) and Novonesis, Darktrace and Criteo (Workday) have been attached, so they are struck from the company lists below; the seed still names them.

Reason Seed Live 2026-09-30 What it means Companies
unread 35 35 readable by a program; no module reads it yet Zalando, Ørsted, Siemens, Google DeepMind, Amazon, Apple, ASML, Netcompany, Tryg, DNB
robots 10 7 the site's robots.txt disallows the page a board would be read from Bang & Olufsen (SuccessFactors), Pandora, Terma, Zenegy, Umbraco, Snyk, Seaborg (HR Manager)
group 8 8 the roles are inside another company's board, with no field that separates them Onfido, Tink, Glovo, Cognigy, Contractbook, Signavio, Native Instruments, Visma
blocked 7 8 the site answers a program with a challenge Tradeshift, Personio, Adjust, Revolut, Silverfin, HashiCorp, Meta
gone 4 5 no careers page wefox, WeTransfer, Featurespace, Unbabel
key 3 3 the only listing answers with a key the page's script carries Maersk, New Work SE, Yousign (Welcome to the Jungle)
added – 14 added by hand or by an import and not looked at yet Danish Centre for AI Innovation, 2021.AI, McKinsey, AMD, Ingka Group and nine more
no reason 9 9 on Teamtailor, but the careers link is a marketing site and the career host is not found Templafy, Queue-it, Telenor, Polestar, IQM, TeamViewer, Tractive, Starship, Factorial

The live counts are companies with no ats board subscription; the company lists are the seed's, less the five attached companies. What is planned for the unread companies and for the gaps in hosts already read (SuccessFactors sites of Tryg, DNB and Allegro, Recruitee on a custom domain, Avature for Siemens) is in docs/plan-hosts-wave-2.md. What is open without a plan is in docs/open.md.