Hiring Signals API — Open Roles & Hiring Surge by Company
Pricing
from $3.00 / 1,000 company hiring signal returneds
Turn a list of companies, ATS boards or a preset into one row per company per run: open roles now, roles opened and closed since your last run, breakdowns by department, location and seniority, remote and salary-disclosure share, top titles and a hiring-surge flag. No API key.
OK
ok
Optional
True on company-signals and role rows. False on diagnostic and run-summary rows, which are never charged.
Row type
rowType
Optional
One of company-signals (one per company per run), role (one per posting, only with emitRoles), diagnostic (could not be resolved or read; free) or run-summary (once per run; free).
Input spellings
input
Optional
Every entry of your input that named this company, in input order — a domain and a board URL for the same account are one row with both spellings here. Null on the run-summary row.
Error
error
Optional
On a diagnostic row, the sentence explaining what went wrong and what to send instead. Null on every other row.
Error type
errorType
Optional
On a diagnostic row, the stable token to branch on: board-not-found, ats-not-detected, slug-guess-rejected, outage-guard, freemail, preset-unknown, robots-disallowed and the rest listed in the README. Null elsewhere.
Read at
scrapedAt
Optional
ISO timestamp of the run that produced the row. Identical on every row of one run.
Source host
source
Optional
The ATS host the board was read from (the API host, not the public board).
Source URL
sourceUrl
Optional
On a company-signals row, the public board URL (same as atsBoardUrl). On a diagnostic row, the exact URL that failed, when there was one.
Company key
companyKey
Optional
The deduplication and join key: ats:slug, case-folded. role rows carry it too, so they join back to their company row.
Company name
companyName
Optional
The name the ATS publishes, else the registry company name, else the board slug title-cased. Clipped at 200 characters.
Company domain
companyDomain
Optional
The domain you sent, else the registry domain, else the registrable domain the postings link to. Never guessed from the slug.
ATS platform
atsPlatform
Optional
greenhouse, lever, ashby, workable, recruitee, smartrecruiters, teamtailor, personio, breezy, workday, jazzhr, bamboohr or rippling.
ATS platform label
atsPlatformLabel
Optional
The platform name for display.
Board slug
atsBoardSlug
Optional
The board identifier on its platform, in the spelling that was read.
Board URL
atsBoardUrl
Optional
The public board a candidate would be sent to — the URL that proves the count.
Board source
boardSource
Optional
ats — read from the company's own applicant-tracking board. (The remote-board fallback that would write aggregator here is planned, not shipped.)
Aggregator boards
aggregatorBoards
Optional
Reserved for the remote-board fallback planned for a later version. Always null in this version.
Resolved from
resolvedFrom
Optional
How the board was tied to the company: input-board, preset, registry, detection-cache, slug-guess or careers-page. With a domain among the spellings, the rung that tied that domain.
Resolution confidence
resolutionConfidence
Optional
1.0 input board or preset, 0.95 registry, 0.9 detection cache (or the original rung's, if lower), 0.8 slug guess on a posting-URL match, 0.7 slug guess on a company-name match, 0.6 careers-page detection.
Resolution evidence
resolutionEvidence
Optional
What tied the board to the domain, in words — the registry entry, the posting URL host, the board's company name or the careers page that linked it. Null for boards you named.
Presets
presets
Optional
The bundled presets this board belongs to, or an empty list.
Open roles
openRoles
Optional
Roles open now, after your filters. Null when the board filled maxRolesPerBoard (truncated). Zero is a real answer and is charged.
Previous open roles
previousOpenRoles
Optional
openRoles at the previous run (monitor mode). Null on a first run and in snapshot mode.
Open roles delta
openRolesDelta
Optional
openRoles minus previousOpenRoles. Null on a first run and in snapshot mode.
New roles
newRoles
Optional
Roles that appeared since the previous run; a role re-posted under a new ID counts once, as new. Null on a first run, in snapshot mode and on a truncated board.
Closed roles
closedRoles
Optional
Roles gone since the previous run. Null on a first run, in snapshot mode and on a truncated board — unread is never closed.
Changed roles
changedRoles
Optional
Roles whose changedFields moved since the previous run. A bare updatedAt bump is never a change.
Reposted roles
repostedRoles
Optional
Of newRoles, how many replaced a closed role with the same title and location under a new ID.
Unchanged roles
unchangedRoles
Optional
Roles still open and unchanged since the previous run.
By department
byDepartment
Optional
Top 10 departments as {value, count, share}; roles with no department are counted under (unspecified). Ties break on count, then value.
By location
byLocation
Optional
Top 10 locations as {value, count, share}. A role listed in several locations counts in each, so shares can sum above 1.
By country
byCountry
Optional
Top 10 ISO 3166-1 alpha-2 countries as {value, count, share}, read exactly as the countryCodes filter reads them; (unspecified) when none could be read.
By seniority
bySeniority
Optional
Counts for the nine seniorityLevels bands, from the title. mid is a title with no seniority word, as the filter defines it; the bands sum to openRoles.
By employment type
byEmploymentType
Optional
Counts for FullTime, PartTime, Contract, Temporary, Internship, Volunteer and Other, plus unknown for roles whose ATS publishes no type.
By workplace type
byWorkplaceType
Optional
Counts for remote, hybrid, onsite and unknown, read as the workplaceTypes filter reads them.
Salary disclosed (count)
salaryDisclosedCount
Optional
Roles carrying a structured pay range from the ATS — never parsed from prose.
Salary currencies
salaryCurrencies
Optional
Currencies of the disclosed ranges as {value, count}.
Top titles
topTitles
Optional
Top 10 title groups as {title, count}; a leading Senior/Staff/Principal/Lead and a trailing location or parenthetical are ignored for grouping, and the most frequent original spelling is shown.
New titles
newTitles
Optional
Titles of this run's new roles, original spellings, newest first, up to 25. Free on the company row. Null when there is no diff.
Hiring surge
hiringSurge
Optional
True when newRoles is at least max(5, 3 x newPerDay30Days), the trailing average before this run. Never true on a first run. Null in snapshot mode and on a truncated board.
New-roles ratio
newRatio
Optional
newRoles divided by newPerDay30Days, the trailing daily average before this run. Null when that average is 0, on a first run and in snapshot mode.
New in the last 7 days
newLast7Days
Optional
New roles over the trailing 7 days of stored history, this run included.
Closed in the last 7 days
closedLast7Days
Optional
Closed roles over the trailing 7 days of stored history, this run included.
New in the last 30 days
newLast30Days
Optional
New roles over the trailing 30 days of stored history, this run included. Read it against historyDays.
Closed in the last 30 days
closedLast30Days
Optional
Closed roles over the trailing 30 days of stored history, this run included.
New per day (30 days)
newPerDay30Days
Optional
The baseline the surge is tested against: new roles per day over the trailing 30 days of history before this run. Null on a first run and in snapshot mode.
History days
historyDays
Optional
Days of history behind newPerDay30Days, today counted, up to 90: 0 on a first run. A 30-day average over 2 days is a 2-day average.
Mode
mode
Optional
monitor or snapshot, as the run was started.
First run
firstRun
Optional
True when monitor mode had no previous snapshot for this company. Null in snapshot mode.
First seen at
firstSeenAt
Optional
On a company row, when this company was first monitored; on a role row, when that role was first seen.
Previous run at
previousRunAt
Optional
When the previous snapshot this row was diffed against was taken. Null on a first run and in snapshot mode.
Last run at
lastRunAt
Optional
This run's timestamp.
Truncated
truncated
Optional
True when the board filled maxRolesPerBoard: the diff is suspended, openRoles and the breakdowns are null and nothing is charged.
Filters applied
filtersApplied
Optional
The result filters that were on, as name=value strings. Every count and share on the row is over the filtered set.
Roles filtered out
rolesFilteredOut
Optional
Roles read from the board and left out by your filters.
Request count
requestCount
Optional
HTTP requests spent on this company: resolving a domain plus reading the board. On the run-summary row, the whole run.
Billable
billable
Optional
Whether this row was charged. False for baseline first runs, truncated boards, every diagnostic and the run summary. A company with zero open roles is billable.
Change type
changeType
Optional
On a role row: new, changed or open.
Job ID
jobId
Optional
On a role row: the posting's ID inside its ATS.
Role board slug
boardSlug
Optional
On a role row: the board the posting came from, as in the Career Site Jobs API row.
Title
title
Optional
On a role row: the job title as published.
Department
department
Optional
On a role row: the department the ATS publishes.
Team
team
Optional
On a role row: the team, when the ATS publishes one separately.
Employment type
employmentType
Optional
On a role row: FullTime, PartTime, Contract, Temporary, Internship, Volunteer or Other.
Seniority
seniority
Optional
On a role row: the band derived from the title; null when the title says nothing.
Location (raw)
locationRaw
Optional
On a role row: the location text exactly as published.
Locations
locations
Optional
On a role row: parsed locations, each with city, region, country, isRemote and note.
Remote
isRemote
Optional
On a role row: true when the ATS or the location text says remote. Titles are never read for this.
Workplace type
workplaceType
Optional
On a role row: onsite, hybrid or remote, when the ATS says so.
Salary min
salaryMin
Optional
On a role row: bottom of the structured pay range.
Salary max
salaryMax
Optional
On a role row: top of the structured pay range.
Salary currency
salaryCurrency
Optional
On a role row: ISO currency of the pay range.
Salary period
salaryPeriod
Optional
On a role row: YEAR, MONTH, WEEK, DAY or HOUR.
Description (text)
descriptionText
Optional
Always null: descriptions are never read on this Actor's path. Run the Career Site Jobs API for posting bodies.
Description (HTML)
descriptionHtml
Optional
Always null, for the same reason as descriptionText.
Apply URL
applyUrl
Optional
On a role row: where to apply.
Job URL
jobUrl
Optional
On a role row: the posting page.
Posted at
postedAt
Optional
On a role row: when the ATS says the role was first published.
Updated at
updatedAt
Optional
On a role row: when the ATS last touched the posting. Never counted as a change on its own.
Changed fields
changedFields
Optional
On a changed role row: which tracked fields moved. Empty on a new role row.
Previous values
previousValues
Optional
On a changed role row: what those fields held at the previous run.
Reposted
reposted
Optional
On a new role row: true when it replaced a closed role with the same title and location under a new ID.
Previous job ID
previousJobId
Optional
On a reposted role row: the ID it replaced.
Tried candidates
triedCandidates
Optional
On an ats-not-detected or robots-disallowed row: up to 8 {rung, url, status, reason} entries — everything the ladder tried.
Companies requested
companiesRequested
Optional
Run summary: distinct companies after presets were expanded and duplicates folded.
Companies resolved
companiesResolved
Optional
Run summary: distinct boards the companies resolved to.
Companies billed
companiesBilled
Optional
Run summary: company-signals rows charged.
Companies free
companiesFree
Optional
Run summary: company-signals rows delivered free — baseline first runs and truncated boards.
Surging companies
surgingCompanies
Optional
Run summary: companies with hiringSurge true.
Total open roles
totalOpenRoles
Optional
Run summary: openRoles summed over the company rows delivered.
Total new roles
totalNewRoles
Optional
Run summary: newRoles summed over the company rows delivered. Null in snapshot mode.
Total closed roles
totalClosedRoles
Optional
Run summary: closedRoles summed over the company rows delivered. Null in snapshot mode.
Registry version
registryVersion
Optional
Run summary: the bundled board registry version the run used.
Preset sizes
presetSizes
Optional
Run summary: how many boards each preset holds.
