# Greenhouse, Lever & Ashby Jobs API (`lirafrt/ats-jobs-hiring-signals`) Actor Fetch public Greenhouse, Lever, and Ashby job boards in one run. Export normalized jobs, compensation, filters, stable hashes, and free hiring summaries. - **URL**: https://apify.com/lirafrt/ats-jobs-hiring-signals.md - **Developed by:** [Murilo Lira](https://apify.com/lirafrt) (community) - **Categories:** Jobs, Lead generation, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.25 / 1,000 ats jobs This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Greenhouse, Lever & Ashby Jobs API Fetch live public job boards from Greenhouse, Lever, and Ashby in one run and receive one stable schema. The Actor detects each provider from its official board URL, preserves source-published compensation, applies deterministic filters, and emits a free hiring summary per board. No ATS login, API key, proxy, or LLM is required. ### What it solves - One input and one dataset for three widely used applicant-tracking systems. - Live source data instead of a centrally cached jobs database. - Consistent title, location, remote, department, employment, description, compensation, date, and application fields. - Cross-company monitoring with global and per-board result caps. - Partial-failure isolation: one invalid board does not erase valid results. - Stable `contentHash` values for downstream change detection. ### Supported URLs ```text https://boards.greenhouse.io/stripe https://jobs.lever.co/leverdemo https://jobs.eu.lever.co/example https://jobs.ashbyhq.com/Ashby ```` Official Greenhouse API URLs, Lever posting API URLs, and Ashby posting API URLs are also accepted and canonicalized. Arbitrary hosts, HTTP, credentials, custom ports, and malformed board IDs are rejected. ### Input example ```json { "sources": [ "https://boards.greenhouse.io/stripe", "https://jobs.lever.co/leverdemo", "https://jobs.ashbyhq.com/Ashby" ], "maxJobs": 100, "maxJobsPerSource": 50, "includeDescriptions": true, "includeCompensation": true, "keywords": ["data", "machine learning"], "excludeKeywords": ["manager"], "remoteOnly": false, "includeSummary": true } ``` Filters run on published fields after one bounded request per board. `publishedAfter` uses Ashby's publication date, Lever's creation timestamp, or Greenhouse's update timestamp. A job with no exact source date is preserved rather than treated as old. ### Normalized job output ```json { "recordType": "job", "source": "ashby", "sourceId": "Ashby", "companyName": null, "jobId": "7458d4e9-da2e-47bd-98cb-adfda43d42b2", "title": "Engineering Manager - EU", "location": "Remote - European Union", "secondaryLocations": [], "country": null, "workplaceType": "remote", "isRemote": true, "department": "Engineering", "team": "EMEA Engineering", "employmentType": "FullTime", "publishedAt": "2024-03-04T14:29:08.532Z", "updatedAt": null, "descriptionText": "...", "descriptionHtml": "...", "compensationSummary": "€76K – €185K • Offers Equity • Offers Bonus", "compensation": {}, "applicationUrl": "https://...", "sourcePageUrl": "https://...", "sourceApiUrl": "https://...", "contentHash": "...", "collectedAt": "2026-07-17T00:00:00Z", "raw": null } ``` `companyName` remains null when the public feed does not publish it; the Actor does not convert a board slug into an asserted legal company name. ### Provider differences | Field | Greenhouse | Lever | Ashby | | --- | --- | --- | --- | | Full description | Public list option | Public posting feed | Public posting feed | | Department/team | When board exposes it | Categories | Native fields | | Remote label | Conservative visible-text detection | Native workplace type | Native boolean/type | | Exact date | Update timestamp | Creation timestamp | Publication timestamp | | Structured compensation | Usually not in list feed | When salary range is published | Official optional compensation response | Unknown values remain `null`; provider differences are not filled with guesses. ### Hiring summaries and run status Each successful board can add a free `hiring-summary` row containing source, match, publication, remote, compensation, department, location, and freshness counts. `RUN_SUMMARY` reports all source failures and the final Greenhouse/Lever/Ashby output mix. ### Cost controls - 256 MB default memory. - One public feed request per source; no browser and no paid proxy. - Global and per-source publication caps. - Descriptions and raw payloads can be disabled to reduce storage. - Store pricing: **$0.00125 per published `ats_job` row** (US$1.25 per 1,000); summaries are included at no extra charge. - One-time `apify-actor-start` event: **$0.00005** per run. ### Source documentation - Greenhouse Job Board data is public and GET endpoints do not require authentication: - Lever publishes its Postings API documentation: - Ashby documents its public Job Postings API and optional compensation response: ### Responsible use Use public job data lawfully and at reasonable rates. This Actor does not access private jobs, employee portals, applicant records, or application-submission endpoints. # Actor input Schema ## `sources` (type: `array`): Official Greenhouse, Lever, or Ashby job-board URLs. Provider and board ID are detected from each URL. ## `maxJobs` (type: `integer`): Global maximum number of job records written. Hiring summaries do not count toward this limit. ## `maxJobsPerSource` (type: `integer`): Prevents one board from consuming the global result limit. ## `includeDescriptions` (type: `boolean`): Include published plain text and HTML descriptions. Disable to reduce dataset size. ## `includeCompensation` (type: `boolean`): Request structured Ashby compensation and preserve structured Lever salary data when published. Greenhouse list feeds normally omit pay ranges. ## `keywords` (type: `array`): Keep jobs containing at least one term in title, location, department, team, or included description. Blank means all jobs. ## `excludeKeywords` (type: `array`): Drop jobs containing any term in the searchable fields. ## `locations` (type: `array`): Keep jobs whose primary or secondary published location contains at least one term. ## `departments` (type: `array`): Keep jobs whose published department or team contains at least one term. ## `employmentTypes` (type: `array`): Case-insensitive substring filters such as Full Time, Contract, or Intern. ## `remoteOnly` (type: `boolean`): Keep only jobs explicitly remote. Hybrid and unknown jobs are excluded. ## `publishedAfter` (type: `string`): Optional inclusive UTC date. Jobs with an unknown source date are preserved. ## `includeSummary` (type: `boolean`): Write one free summary per readable board with source, match, remote, compensation, department, location, and freshness counts. ## `maxConcurrency` (type: `integer`): Concurrent public board requests. ## `requestTimeoutSecs` (type: `integer`): Per-request timeout in seconds. ## `maxRetries` (type: `integer`): Retries for rate limits, timeouts, and transient server errors. ## `includeRaw` (type: `boolean`): Attach each provider payload for debugging. This increases dataset size. ## Actor input object example ```json { "sources": [ "https://boards.greenhouse.io/stripe", "https://jobs.ashbyhq.com/Ashby" ], "maxJobs": 500, "maxJobsPerSource": 500, "includeDescriptions": true, "includeCompensation": true, "keywords": [], "excludeKeywords": [], "locations": [], "departments": [], "employmentTypes": [], "remoteOnly": false, "includeSummary": true, "maxConcurrency": 5, "requestTimeoutSecs": 20, "maxRetries": 2, "includeRaw": false } ``` # Actor output Schema ## `dataset` (type: `string`): Normalized public jobs and records whose recordType is hiring-summary. ## `runSummary` (type: `string`): Provider outcomes, publication totals, source mix, and charge-limit state. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sources": [ "https://boards.greenhouse.io/stripe", "https://jobs.lever.co/leverdemo", "https://jobs.ashbyhq.com/Ashby" ] }; // Run the Actor and wait for it to finish const run = await client.actor("lirafrt/ats-jobs-hiring-signals").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sources": [ "https://boards.greenhouse.io/stripe", "https://jobs.lever.co/leverdemo", "https://jobs.ashbyhq.com/Ashby", ] } # Run the Actor and wait for it to finish run = client.actor("lirafrt/ats-jobs-hiring-signals").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sources": [ "https://boards.greenhouse.io/stripe", "https://jobs.lever.co/leverdemo", "https://jobs.ashbyhq.com/Ashby" ] }' | apify call lirafrt/ats-jobs-hiring-signals --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=lirafrt/ats-jobs-hiring-signals", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Greenhouse, Lever & Ashby Jobs API", "description": "Fetch public Greenhouse, Lever, and Ashby job boards in one run. Export normalized jobs, compensation, filters, stable hashes, and free hiring summaries.", "version": "0.1", "x-build-id": "4upV1em7oJRAusNaH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lirafrt~ats-jobs-hiring-signals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lirafrt-ats-jobs-hiring-signals", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/lirafrt~ats-jobs-hiring-signals/runs": { "post": { "operationId": "runs-sync-lirafrt-ats-jobs-hiring-signals", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/lirafrt~ats-jobs-hiring-signals/run-sync": { "post": { "operationId": "run-sync-lirafrt-ats-jobs-hiring-signals", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "sources" ], "properties": { "sources": { "title": "Public ATS board URLs", "minItems": 1, "maxItems": 50, "type": "array", "description": "Official Greenhouse, Lever, or Ashby job-board URLs. Provider and board ID are detected from each URL.", "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "maxJobs": { "title": "Maximum jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Global maximum number of job records written. Hiring summaries do not count toward this limit.", "default": 500 }, "maxJobsPerSource": { "title": "Maximum jobs per source", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Prevents one board from consuming the global result limit.", "default": 500 }, "includeDescriptions": { "title": "Include descriptions", "type": "boolean", "description": "Include published plain text and HTML descriptions. Disable to reduce dataset size.", "default": true }, "includeCompensation": { "title": "Include published compensation", "type": "boolean", "description": "Request structured Ashby compensation and preserve structured Lever salary data when published. Greenhouse list feeds normally omit pay ranges.", "default": true }, "keywords": { "title": "Include keywords", "maxItems": 30, "type": "array", "description": "Keep jobs containing at least one term in title, location, department, team, or included description. Blank means all jobs.", "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "default": [] }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 30, "type": "array", "description": "Drop jobs containing any term in the searchable fields.", "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "default": [] }, "locations": { "title": "Locations", "maxItems": 30, "type": "array", "description": "Keep jobs whose primary or secondary published location contains at least one term.", "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "default": [] }, "departments": { "title": "Departments or teams", "maxItems": 30, "type": "array", "description": "Keep jobs whose published department or team contains at least one term.", "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "default": [] }, "employmentTypes": { "title": "Employment types", "maxItems": 20, "type": "array", "description": "Case-insensitive substring filters such as Full Time, Contract, or Intern.", "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "default": [] }, "remoteOnly": { "title": "Explicitly remote only", "type": "boolean", "description": "Keep only jobs explicitly remote. Hybrid and unknown jobs are excluded.", "default": false }, "publishedAfter": { "title": "Published or updated on/after", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Optional inclusive UTC date. Jobs with an unknown source date are preserved." }, "includeSummary": { "title": "Publish hiring summaries", "type": "boolean", "description": "Write one free summary per readable board with source, match, remote, compensation, department, location, and freshness counts.", "default": true }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Concurrent public board requests.", "default": 5 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 5, "maximum": 60, "type": "integer", "description": "Per-request timeout in seconds.", "default": 20 }, "maxRetries": { "title": "Maximum retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries for rate limits, timeouts, and transient server errors.", "default": 2 }, "includeRaw": { "title": "Include raw source job", "type": "boolean", "description": "Attach each provider payload for debugging. This increases dataset size.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```