diff --git a/plugins/README.md b/plugins/README.md index 1b9cc75..597cc8a 100644 --- a/plugins/README.md +++ b/plugins/README.md @@ -1,52 +1,89 @@ # 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 and the live database of 2026-09-29. 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. +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 `enrich:` 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 | 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 | +| `narrowed` | `stamp`, a read by fetch terms | `close_boards`: closes nothing | +| `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 a whole read listed | `_runner.read`, the 10% guard | +| `missing` | `close_boards` (`_close_swept`), the ids the last finished sweep missed | the next finished sweep | +| `failing` | `ats._board` through `record_failure`, `{since, reason}`; removed on the next answer | `close_boards` (21 days), the Companies list, `enrich` | +| `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` (`enrich`): 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 | `enrich.plan` through `detail_due` | + +4. `close_boards`, the settle of the pull, closes what a complete read did not list, closes a board that failed for `STALE_DAYS`, and releases the run. +5. Then, in order: `prep` (maps the hosts' words, resolves places and company aliases, folds copies with `app/dupes.py`), `embed`, `score`, `enrich` (reads the role pages of the best-ranked roles without text), `prep`, `embed` and `score` again for the roles it filled (skipped when it filled none), `extract`, `score`, `summarise`. Extract and summarise are switches under Runs; enrich is on by default. + ## The three ways a source is read -**Whole board.** One request returns every role on the board with its text. The read is complete whenever the answer parses, so the pull can close every role the answer no longer lists. +**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, read one after another 0.5 s apart, at most 100 pages per board. The read is complete when the number of distinct roles read equals the total the host states, or, for a host that states none, when the read reaches an empty page. A board larger than 100 pages is read incomplete on every pull (see the shared rules). +**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. The text is on each role's own page, which is read once per role: at most 200 roles per board per pull, roles never tried before roles whose read failed. A new board of 800 roles has all its text after four pulls. Until its own page is read, a role is in the feed with title, place and the list's date, and it is ranked without its text. Three consequences follow from the code: +**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 `enrich` stage reads those pages after scoring (`app/jobs/enrich.py`): -- `embed` encodes a role once. A role listed before its page was read is encoded from its title; when the text arrives on a later pull its vector is dropped, and the next `embed` encodes it again with the text. Until then its fit is the title's. -- The per-role read may fill only description, place, remote, 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. +- It takes open roles without text that an enabled agent with a prompt ranks ungated within its best `enrich.top` (500) at `enrich.min_score` (0.5) or above, best score first. +- It reads at most `enrich.per_board` (200) roles per board and `enrich.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 `enrich.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 and after a star change, not after a vote, and it can be switched off under Runs. + +A role below the bar for every agent 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 that rank 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 `enrich` 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 after the pull of 2026-09-29. For the "list, then each role" hosts the description share is after one pull and rises by up to 200 roles per board per pull. +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 `enrich` has read. | Source | Boards | Open roles | How it is read | Roles per request | Description | Pay | Limit that matters most | |---|---|---|---|---|---|---|---| -| Greenhouse | 85 | 10,216 | whole board | all | in the list | figures | a board over 96 MiB loses its text and pay | -| SmartRecruiters | 10 | 7,238 | paged | 100 | none | none | no text: ranked on the title alone | -| Ashby | 69 | 4,261 | whole board | all | in the list | figures | an unknown board name answers an empty board | -| SuccessFactors | 14 | 3,738 | list, then each role | the site's own | per role | none | default locale only | -| Workday | 13 | 2,377 | list, then each role | 20 | per role | none | 2,000 roles per board; country arrives per role | -| Lever | 24 | 1,033 | whole board | all | in the list | figures | one place per role | -| Phenom | 3 | 1,007 | list, then each role | 100 | per role | none | three sites checked | -| Oracle Recruiting Cloud | 4 | 826 | list, then each role | 200 | per role | none | no pay field | -| Eightfold | 1 | 630 | list, then each role | 10 | per role | none | 1,000 roles per board | -| Teamtailor | 35 | 598 | paged | 50 | in the list | none | no pay; nine companies without a found site | -| Jobindex (search) | – | 538 | paged | 20 | excerpt in the list | none | excerpt only; at most 200 results per search | -| Platsbanken (search) | – | 446 | paged | 100 | in the list | none | at most 1,000 results per search | -| Personio | 3 | 322 | whole board | all | in the list | figures | one place, no country | -| Recruitee | 8 | 177 | whole board | all | in the list | figures | an empty board looks like no board to discovery | -| Workable | 7 | 153 | paged | 10 | none | none | no text: ranked on the title alone | -| Jibe | 1 | 140 | paged | 100 | in the list | none | Booking Holdings' roles read with Booking.com's | +| 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 | 44 | list, then each role | all | per role | none | undocumented query, can break | -| Jobylon | 2 | 33 | list, then each role | all | per role | none | scraped from the careers widget | +| 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 | paged | 50 | excerpt in the list | figures | never run live; needs a key | -| HR Manager | 0 | 0 | paged | 100 | in the list | none | not attached: the portal's robots.txt disallows reading | +| Adzuna (search) | 0 | 0 | paged | 50 | teaser | figures | never run live; needs a key | "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. @@ -54,28 +91,28 @@ Numbers are from the live database after the pull of 2026-09-29. For the "list, | Limit | Value | What it means | |---|---|---| -| Schedule | `pull` every 6 h by default, editable under Runs | Each pull starts the cascade `pull`, `embed`, `score`, `extract`, `score`, `summarise`; `extract` and `summarise` are off 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. One pull runs at a time. | +| 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); enrich 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; 15 s per request for the search providers | A slow board fails for this pull and is asked again next pull. | -| Pages per board | 100 | 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 and before every per-role read; none between search pages | The list of a Workday board of 1,000 roles spends about 25 s waiting. | -| Per-role reads | 200 per board per pull | The rest wait for the next pull. A 404 or 410 counts as read; another failure is retried on a later pull. | -| Closing a role | after a complete read, every open role of the board it did not list | An incomplete read closes nothing. A role listed again reopens. A board switched off closes its roles at once. | -| 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 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 board that fails for 21 days | all its open roles close at the next pull | The next answer reopens what it lists. | +| 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 | `enrich`, after scoring: 200 per board and 1,000 per run, ranked roles first | See "List, then each role". Roles the agents do not rank 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. 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; a read by fetch terms closes nothing. | +| 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 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, and a filtered, terms or `empty="suspect"` read that lists under 10% of what the same read listed last time (`SUSPECT_SHARE`). A search that fails is skipped for the pull and leaves no record. | +| A board that fails for 21 days | all its open roles close at the next pull | 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 per-role read: the per-role reads of that board stop until the next pull | Nothing is closed on a list cut short by a 429. A search that fails is skipped for the pull. | +| 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 enrich run | Nothing is closed on a list cut short by a 429. | -How far a board is read: a pull asks each board over 300 roles 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 30 times, 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. +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, one never read whole, 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 (an AND on every host the survey tested). 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. Every host matches the whole text, not only the title, 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. +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. +- 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. @@ -89,14 +126,14 @@ What no source does: | | | |---|---| | Target | the board token, e.g. `greenhouse:trustpilot` | -| Companies | 85 boards: Trustpilot, Cognite, Wolt | +| Companies | 87 boards: Trustpilot, Cognite, Wolt | | List | `boards-api.greenhouse.io/v1/boards//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`); live: 10,216 of 10,216 | -| Date | `first_published`, else `updated_at`; trusted as the posting date | -| Place and country | `location.name`, one place; the app reads the country from that line (9,307 of 10,216) | -| Remote | none from the host; the app reads remote or hybrid from the place line (2,131 roles) | -| 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. Live: 2,170 with figures, 2,503 with a line | +| 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. | @@ -105,32 +142,34 @@ What no source does: | | | |---|---| | Target | the site name, or `eu/` on Lever's EU instance, e.g. `lever:spotify`, `lever:eu/tomtom` | -| Companies | 24 boards: Spotify, TomTom, Pipedrive | +| Companies | 26 boards, one switched off: Spotify, TomTom, Pipedrive | | List | `api.lever.co/v0/postings/?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; live: 1,023 of 1,033 | +| 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`, one place; `allLocations` is not read; country from that line (1,012 of 1,033) | -| Remote | `workplaceType`, the host's own word (1,032 of 1,033) | -| Pay | figures from `salaryRange` for `per-year-salary` and `per-month-salary` (×12); other intervals a line only; live: 207 with figures, 210 with a line | +| 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 one place per role is read. | +| 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 | 69 boards: Pleo, Too Good To Go, Lovable | +| Companies | 74 boards: Pleo, Too Good To Go, Lovable | | List | `api.ashbyhq.com/posting-api/job-board/?includeCompensation=true`, the whole board in one answer; no total | | Requests per pull | 1 | -| Description | in the list, full text (`descriptionHtml`); live: 4,261 of 4,261 | +| Description | in the list, full text (`descriptionHtml`) | | Date | `publishedAt`; trusted | -| Place and country | `location`, one place; secondary places are not read; country from that line (4,003 of 4,261) | -| Remote | `isRemote`, true or false (2,625 with a value) | -| Pay | figures from the first `Salary` component with interval `1 YEAR` or `1 MONTH` (×12); an hourly one a line only; bonus and equity appear in the line only. Live: 1,482 with figures, 1,499 with a line | +| 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, and a mistyped name reads as an empty, complete board. The name is read without case, so a lowercased slug works. | +| 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 @@ -140,11 +179,12 @@ What no source does: | Companies | 8 boards: bunq, idealo, Climeworks | | List | `https://.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); live: 177 of 177 | +| Description | in the list, `description` only (`requirements` is not read) | | Date | `published_at`, else `created_at`; trusted | -| Place and country | `location`, else `city`, one place; country from that line (149 of 177) | -| Remote | `remote`, true or false (29 with a value) | -| Pay | figures from `salary` for period `year` and `month` (×12); other periods a line only; live: 12 with figures, 41 with a line | +| 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 `.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). | @@ -156,11 +196,12 @@ What no source does: | Companies | 3 boards: Penneo, tado, 1KOMMA5° | | List | the XML feed `https://.jobs.personio.de/xml`, the whole board in one answer; no total | | Requests per pull | 1 | -| Description | in the list, every `jobDescription` value joined; live: 321 of 322 | +| Description | in the list, every `jobDescription` value joined | | Date | `createdAt`; trusted | -| Place and country | `office`, one place, no country field; country from that line (232 of 322) | -| Remote | true when the office text contains "remote", else unknown (37 roles) | -| Pay | figures from `salaryInformation` for `yearly` and `monthly` (×12); hourly, daily, weekly a line only; live: 1 role | +| 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/`. Only the feed's default language is read. The company Personio itself is on the Watchlist as `blocked`. | @@ -172,11 +213,12 @@ What no source does: | Companies | 1 board: Xeneta | | List | `https://.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; live: 2 of 2 | +| 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 from that line | +| Place and country | `location.name` (else `city`) plus `province`, one place; country resolved from that line | | Remote | `workplace_type`: onsite, hybrid, remote | -| Pay | figures when `compensation_visible`, for annual and monthly (×12) frequencies; others a line only. The frequency spellings are guessed, since no board read so far shows pay | +| 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 `.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. | @@ -188,11 +230,12 @@ What no source does: | Companies | 1 board: Klarna | | List | the HTML page `https://jobs.deel.com/`, 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`); live: 96 of 96 | +| 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, joined with "; "; country from that line (91 of 96) | -| Remote | `workArrangementEnum`: onsite, hybrid, remote (95 of 96) | -| Pay | line only, when visible: currency and two amounts with no period, so no yearly figure can be told from a monthly one (90 roles) | +| 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. | @@ -202,68 +245,34 @@ What no source does: |---|---| | Target | the subdomain of `careers.hibob.com`, e.g. `hibob:dixa` | | Companies | 1 board: Dixa | -| List | `https://.careers.hibob.com/api/job-ad` with the header `companyIdentifier: `, the whole board in one answer; no total | +| List | `https://.careers.hibob.com/api/job-ad` with the header `companyIdentifier: `, 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; live: 2 of 2 | +| 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`, one place | +| 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 | -| Pay | figures from the `payTransparency*` fields for year and month (×12); hour, day and week a line only. No board seen had them filled, so the period spellings are guessed | +| 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 `.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 -### SmartRecruiters - -| | | -|---|---| -| Target | the company identifier, e.g. `smartrecruiters:BoschGroup` | -| Companies | 10 boards: Bosch (about 4,800 roles), Delivery Hero, Wise | -| List | `api.smartrecruiters.com/v1/companies//postings`, 100 per request by offset; states `totalFound` | -| Requests per pull | roles / 100, rounded up; 49 for Bosch | -| Description | none. The list carries no text, and the module does not read the per-posting endpoint, which would cost one request per role. These 7,238 roles are ranked on the title alone, and `extract` and `summarise` have nothing to read. Live: 0 of 7,238 | -| Date | `releasedDate`; trusted | -| Place and country | `fullLocation`, else city and country; country 7,230 of 7,238 | -| Remote | `location.remote`, true or false (122 remote) | -| 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 below. Fetch terms as `?q=engineer`, one a request, AND with the country; it matches title and text (Bosch: 1,713 of 4,830) | -| Limitations | 10,000 roles per board (100 pages). The identifier is read without case, so a lowercased slug works. An unknown identifier answers an empty list, not an error: a mistyped slug reads as a complete board with no roles and would close a company's roles. | - -The reader's "Fetch the posting" button shows for these roles, since their description is empty; it reads one posting page on demand and does not feed `embed` or `extract`. Whether it reads a SmartRecruiters page cleanly was not checked. - -### Workable - -| | | -|---|---| -| Target | the account name, e.g. `workable:huggingface` | -| Companies | 7 boards: Hugging Face, Kahoot!, Starling Bank | -| List | a POST to `apply.workable.com/api/v3/accounts//jobs`, 10 per request with a `nextPage` token; states `total` | -| Requests per pull | roles / 10, rounded up, 0.5 s apart; at most 16 for any board attached (153 roles in all) | -| Description | none. The text is only on a per-role endpoint, which the module does not call. These roles are ranked on the title alone, and `extract` and `summarise` have nothing to read. Live: 0 of 153 | -| Date | `published`; trusted | -| Place and country | city, region and country joined; country 153 of 153 | -| Remote | the `remote` flag or `workplace` remote gives remote; the rest is stored as unknown (22 remote); hybrid is not read | -| Pay | none: the list states no pay | -| Found by discovery | yes, from an `apply.workable.com` or `.workable.com` link; not probed, since a run of guesses trips Workable's rate limit | -| Limitations | 1,000 roles per board (100 pages of 10). Workable answers bursts with 429, which is why pages are 0.5 s apart; a 429 after the first page ends the read incomplete. The role link is built from the shortcode. | - ### 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 | 35 boards: Lunar, Trackunit, DFDS | +| Companies | 38 boards: Lunar, Trackunit, DFDS | | List | the RSS feed `https:///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; at most 13 for any board attached (598 roles in all) | -| Description | in the list, full text; live: 598 of 598 | +| 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 "city, country", joined with "; "; country 582 of 598 | -| Remote | `remoteStatus`: fully is remote, hybrid, onsite; `none` and `temporary` stay unknown (290 with a value) | +| 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 `.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 | 5,000 roles per board; a board of exactly 5,000 is also incomplete, since no empty page is reached. 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. | +| 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 @@ -273,10 +282,11 @@ The reader's "Fetch the posting" button shows for these roles, since their descr | Companies | 1 board: Booking.com | | List | `https:///api/jobs?limit=100&page=`, 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; live: 140 of 140 | +| 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`, several places joined by the host; country 140 of 140 | +| 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. | @@ -285,8 +295,8 @@ The reader's "Fetch the posting" button shows for these roles, since their descr | | | |---|---| -| Target | the portal's customer name, e.g. `hrmanager:stsgroup_tr` | -| Companies | none attached; Seaborg, the one seed company on it, is on the Watchlist as `robots` | +| 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//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 | @@ -295,10 +305,49 @@ The reader's "Fetch the posting" button shows for these roles, since their descr | 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. The owner decided to leave Seaborg unattached. Without `take` the host answers 25 roles. | +| 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 `enrich` 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//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//postings/`: the `jobAd.sections` `jobDescription`, `qualifications` and `additionalInformation`, joined; `companyDescription` is the same blurb on every role and is left out. Read by `enrich` for ranked roles 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 `enrich` 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//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//jobs/`: `description`, `requirements` and `benefits`, joined. The row keeps the `shortcode`, since `source_id` is the numeric id. Read by `enrich` for ranked roles 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 `.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 | | | @@ -306,83 +355,84 @@ The reader's "Fetch the posting" button shows for these roles, since their descr | 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=`, 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, plus up to 200 role pages; per-board sizes are not in these notes | -| Description | per role, the `itemprop="description"` block of the role page; live: 1,651 of 3,738 after one pull | +| 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; country 3,675 of 3,738 | -| Remote | none | +| 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 below. 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 per board, so 1,000 to 10,000 roles depending on the page size. 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. | +| 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 | `./`, site with case, e.g. `workday:lego.wd103/LEGO_External` | -| Companies | 13 boards: LEGO Group, Zendesk, Equinor | +| Companies | 17 boards: LEGO Group, Zendesk, Equinor, and since 2026-09-30 Criteo, Darktrace, Novonesis and NVIDIA | | List | a POST to `/wday/cxs///jobs`, 20 per request by offset (21 or more answers 400); the first page states the total | -| Requests per pull | roles / 20, rounded up, plus up to 200 role reads; for a board of 1,000 roles 50 + 200 on the first pull | -| Description | per role, `jobDescription` from the role's JSON; live: 1,411 of 2,377 after one pull | +| 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. The country therefore arrives with the per-role read: 1,724 of 2,377 after one pull | -| Remote | `remoteType`, where the tenant sends it: remote, hybrid, onsite (585 with a value) | +| 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 below. 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). A tenant has several sites and each is its own board. robots.txt paths are matched without case, as Workday serves any case. Every tenant is behind Cloudflare and was read from this machine only. | +| 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 | `/`, e.g. `oracle:fa-evmr-saasfaprod1.fa.ocs.oraclecloud.com/CX_1` | -| Companies | 4 boards: Danske Bank, Nokia, Milestone Systems, Sinch | +| 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, plus up to 200 role reads; 3 + 200 for Nokia's roughly 600 on the first pull | -| Description | per role: external description, responsibilities and qualifications joined; the list's one-paragraph `ShortDescriptionStr` is not stored; live: 432 of 826 after one pull | +| 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, joined with "; "; country 769 of 826 | -| Remote | `WorkplaceTypeCode`: remote, hybrid, onsite (741 with a value) | +| 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 below. 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 four boards. | +| 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 | 3 boards: King, Just Eat Takeaway.com, Philips | +| Companies | 5 boards: King, Just Eat Takeaway.com, Philips, BCG, Verisure | | List | a POST to `https:///widgets`, 100 per request by offset; states `totalHits` | -| Requests per pull | roles / 100, rounded up, plus up to 200 role pages; 9 + 200 for Philips' 865 on the first pull | -| Description | per role, the JSON-LD `JobPosting` description of the role page; the list's `descriptionTeaser` is not stored; live: 335 of 1,007 after one pull | -| Date | the list's `postedDate`; the role page's `datePosted` replaces it when earlier (Philips' list gave the day of the read for a role posted 2026-09-08); trusted | -| Place and country | every place of `multi_location`, joined with "; "; country 975 of 1,007 | -| Remote | per role only, from the page's `checkRemote` (120 with a value) | +| 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 `///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 below. 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 `_`, the spelling of the three sites read; another site may spell it differently. 10,000 roles per board. A role page without a description fails the read and is retried on a later pull. | +| 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 `_`, 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 | `/`, e.g. `eightfold:jobs.ericsson.com/ericsson.com` | -| Companies | 1 board: Ericsson | +| Companies | 3 boards: Ericsson, Microsoft, Infineon | | List | `https:///api/pcsx/search?domain=&sort_by=timestamp`, newest first, 10 per request whatever `num` asks; states `count` | -| Requests per pull | roles / 10, rounded up, at most 100, plus up to 200 `position_details` reads; 63 + 200 for Ericsson's 630 on the first pull | -| Description | per role, `jobDescription`; live: 200 of 630 after one pull | -| Date | `postedTs`; not trusted, so the role counts as posted when first seen | -| Place and country | every location, repeated names dropped, joined with "; "; country 622 of 630 | -| Remote | `workLocationOption`: onsite, hybrid, remote (628 with a value) | +| 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=`, one country a request; no remote. Ericsson SE: 154 of 618 (2026-09-30). Which countries is the agents' reach, see below. 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 board over 1,000 roles is never read to the end; unless the country filter brings it under the cap: Infineon (1,289, 163 in DK and SE) and Microsoft (about 2,300, 60) become readable that way. Verified on three tenants only. | +| Filter at the source | `location=`, 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 @@ -390,15 +440,16 @@ The reader's "Fetch the posting" button shows for these roles, since their descr |---|---| | 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 | -| Requests per pull | 1, plus one GraphQL POST per role not yet read (at most 200) | -| Description | per role, `descriptionHtml`; live: 44 of 44 | +| 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's city, joined with "; "; `isoCountry` is fetched and not used; country from the line (41 of 44) | -| Remote | `locationType`: onsite, hybrid, remote (44 of 44) | +| 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, so a wrongly cased or mistyped name reads as an empty, complete board. | +| 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 @@ -406,12 +457,13 @@ The reader's "Fetch the posting" button shows for these roles, since their descr |---|---| | 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//embed/v2/`, whose script literal holds the whole board; no total | -| Requests per pull | 1, plus one role page on `emp.jobylon.com` per role not yet read (at most 200); 1 + 33 for Einride on the first pull | -| Description | per role, the JSON-LD description of the role page; live: 33 of 33 | +| List | the careers widget's embed page `cdn.jobylon.com/jobs/companies//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; country 32 of 33 | -| Remote | `workspace`: remote, hybrid, onsite (32 of 33) | +| 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. | @@ -423,14 +475,15 @@ The reader's "Fetch the posting" button shows for these roles, since their descr | 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//jobs`, the whole board in one array, one entry per role and place, merged by role; no total | -| Requests per pull | 1, plus one role record per role not yet read (at most 200); 1 + 2 for Prisma | -| Description | per role, `description.role`; live: 2 of 2 | +| 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, joined with "; "; the per-role read fills every work location | -| Remote | remote only when every place label starts with "remote"; otherwise unknown | -| Pay | figures, per role only, when the record has exactly one pay range with YEAR or MONTH (×12) frequency; no pay line | +| 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 per-role read. Several pay zones give no figures. A wrongly cased slug answers `Job Board not found` and fails the board. | +| 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 @@ -439,33 +492,34 @@ The reader's "Fetch the posting" button shows for these roles, since their descr | Target | the subdomain, e.g. `bamboohr:configit` | | Companies | 1 board: Configit | | List | `https://.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, plus one `/careers//detail` per role not yet read (at most 200); 1 + 2 for Configit | -| Description | per role; live: 2 of 2 | +| Requests per pull | 1 | +| Description | per role, `/careers//detail` | | Date | per role only, `datePosted`; trusted | -| Place and country | the list's city and state; the country arrives with the per-role read | +| 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 `.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. The text a provider sends is stored as the description; the reader shows "Fetch the posting" for any role whose description is under 500 characters, which fetches the posting page once, on demand, and stores it beside the description. The fetched text is what the reader and `summarise` use; `embed` and `extract` read the description only. A search that fails is skipped for the pull. No provider reads robots.txt. +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) 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. Complete when a page within the limit comes back short | +| 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; live: 537 of 538 have one. The full text only through "Fetch the posting", on demand, since every fetch of Jobindex's link counts as a click in its statistics | +| 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 | from place and title words (41 roles) | +| 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. | +| 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 @@ -474,10 +528,10 @@ A saved search is a query with its parameters, stored as a `search` subscription | 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; live: 446 of 446. The code does not say whether this is the whole ad or a shortened one | +| Text | `description.text` of the ad, the whole ad | | Date | `publication_date`; trusted | -| Place | the municipality, else the region; country always Sweden | -| Remote | from headline words only, since `workplace_model` is mostly empty (0 roles) | +| 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. | @@ -489,10 +543,10 @@ A saved search is a query with its parameters, stored as a `search` subscription | 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//search/`, newest first, 50 per page; states `count` | | Pages read | 5 by default (250 results), 10 at most (500) | -| Text | Adzuna's `description` snippet; its length is not stated in the code | +| 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 | from title words only | +| 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. | @@ -501,16 +555,17 @@ Jobnet and Jooble were left out: Jobnet's search answers 401 outside its own sit ## Sources that cannot be read, and why -76 of the 362 seed companies have no board and are on the Watchlist with a careers link opened on 2026-09-29. +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 | Count | What it means | Companies | -|---|---|---|---| -| `unread` | 35 | readable by a program; no module reads it yet | Zalando, Ørsted, Siemens, Infineon, Microsoft, Google DeepMind, Amazon, Apple, ASML, Netcompany, Tryg, DNB | -| `robots` | 10 | the site's robots.txt disallows the page a board would be read from | Novonesis, Darktrace, Criteo (Workday), Bang & Olufsen (SuccessFactors), Pandora, Terma, Zenegy, Umbraco, Snyk, Seaborg (HR Manager) | -| `group` | 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 | the site answers a program with a challenge | Tradeshift, Personio, Adjust, Revolut, Silverfin, HashiCorp, Meta | -| `gone` | 4 | no careers page | wefox, WeTransfer, Featurespace, Unbabel | -| `key` | 3 | the only listing answers with a key the page's script carries | Maersk, New Work SE, Yousign (Welcome to the Jungle) | -| no reason | 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 | +| 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 | -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`. +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`.