ATS Jobs & Change Feed

Normalize public Greenhouse, Lever, Lever EU, and Ashby job boards into one stable schema. Use snapshot mode for a current export or changes mode to emit only NEW, UPDATED, and REMOVED records compared with a prior snapshot.

Why this Actor

• Uses the ATS providers' public job-board APIs; no applicant data, cookies, or customer credentials are requested.
• Emits stable canonical_job_id and content_hash values.
• Deduplicates before writing dataset items, so duplicate records are not emitted as billable results.
• Keeps source errors in the OUTPUT summary instead of disguising an error as a successful job record.
• Preserves source URLs and direct application links.

Input

Add each public board to sources with its provider and board token. For example, stripe for Greenhouse, spotify for Lever, or ashby for Ashby. The optional companyName becomes the normalized display name when the public API does not include one.

For a recurring change feed, set outputMode to changes and select the prior run's current_snapshot_dataset_id in previousDatasetId. The dataset picker requests read-only access so the chain also works when the Actor runs with limited permissions. Every changes run stores a fresh full snapshot separately and reports its ID in the OUTPUT summary, so that ID becomes the baseline for the next run. You can alternatively pass normalized items inline as previousJobs, but do not provide both inputs.

If the selected dataset is inaccessible or is not a compatible snapshot, the run fails before fetching any boards. OUTPUT reports a stable error_code and an actionable error_message; no partial change feed is emitted against a missing or malformed baseline.

Output

Each dataset item includes stable identity, normalized title/company/location, description, direct application and job URLs, provider provenance, timestamps, and a change_type. The default key-value-store record OUTPUT contains source counts, deduplication totals, event counts, the next snapshot dataset ID, and explicit partial-failure details.

Scope

This Actor reads published employer job postings only. It does not submit job applications, collect candidate data, bypass access controls, or scrape private ATS administration APIs.