# ATS Universal Job Scraper (`maverickpoint/ats-universal-scraper`) Actor One scraper for all ATS platforms. Auto-detects Greenhouse, Lever, and Ashby from career URLs. Unified output with skills extraction, classification, change detection, and analytics across 20,000+ companies. - **URL**: https://apify.com/maverickpoint/ats-universal-scraper.md - **Developed by:** [Rahul Sharma](https://apify.com/maverickpoint) (community) - **Categories:** Jobs, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results 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 ## ATS Universal Job Scraper **Stop managing three scrapers.** One input, 20,000+ companies across Greenhouse, Lever, and Ashby. Auto-detects the ATS platform. Unified output schema. Paste any mix of career page URLs. The scraper detects whether each company uses Greenhouse, Lever, or Ashby, routes to the correct extraction pipeline, and outputs unified, enriched data. **No API key needed.** All three ATS platforms expose public job board APIs. ### How it works ```` You paste: We detect & extract: ─────────────────────────────── ───────────────────────── boards.greenhouse.io/stripe → Greenhouse pipeline → unified output jobs.lever.co/spotify → Lever pipeline → unified output jobs.ashbyhq.com/notion → Ashby pipeline → unified output ```` Every job gets the same enrichment regardless of platform: skills extraction, seniority classification, category standardization, work mode detection, and salary data. ### Platform coverage | Platform | Companies | Examples | |---|---|---| | **Greenhouse** | 7,500+ | Airbnb, Stripe, Figma, Webflow, HubSpot, Datadog, Coinbase | | **Lever** | 5,000+ | Spotify, Palantir, Outreach | | **Ashby** | 1,000+ | Notion, Linear, Ramp, Plaid, Vercel, Supabase, PostHog | ### Quick start #### Mix companies from any platform ```json { "careerUrls": [ "https://boards.greenhouse.io/stripe", "https://boards.greenhouse.io/airbnb", "https://jobs.lever.co/spotify", "https://jobs.ashbyhq.com/notion", "https://jobs.ashbyhq.com/ramp" ], "enableClassification": true, "enableSkillsExtraction": true } ```` #### Monitor hiring changes across platforms ```json { "careerUrls": [ "https://boards.greenhouse.io/stripe", "https://jobs.lever.co/spotify", "https://jobs.ashbyhq.com/notion" ], "enableChangeDetection": true, "deltaOnly": true } ``` #### Use plain slugs with a default platform ```json { "careerUrls": ["webflow", "figma", "stripe"], "defaultPlatform": "greenhouse" } ``` ### Unified output Every job includes a `platform` field so you know the source. The rest of the schema is consistent: ```json { "jobId": "abc-123", "title": "Senior Backend Engineer", "company": "Notion", "boardToken": "notion", "platform": "ashby", "location": "San Francisco, California", "department": "Engineering", "applyUrl": "https://jobs.ashbyhq.com/notion/abc-123/application", "payRanges": [ { "title": "Salary", "minValue": 180000, "maxValue": 240000, "currency": "USD", "interval": "yearly" } ], "seniority": "senior", "category": "engineering", "workMode": "hybrid", "skills": { "required": ["Python", "PostgreSQL", "AWS"], "preferred": ["Kubernetes"], "yearsExperience": "5+" }, "scrapedAt": "2026-04-01T12:00:00.000Z", "source": "ashby" } ``` **Platform-specific bonus fields** are preserved when available: - **Greenhouse**: `offices`, `applicationQuestions`, `internalJobId` - **Lever**: `team`, `commitment`, `hostedUrl`, `sections` (structured lists) - **Ashby**: `team`, `employmentType`, `secondaryLocations`, `addressCountry`, `isRemote`, multi-tier compensation (salary+equity+bonus) ### Features | Feature | Description | |---|---| | **Auto-detection** | Detects Greenhouse, Lever, or Ashby from URL | | **Skills extraction** | 500-term taxonomy, required vs preferred | | **Classification** | Seniority (intern→c-level), category (13), work mode | | **Change detection** | Track new/updated/removed between runs | | **Deduplication** | Cross-platform duplicate detection | | **Salary estimation** | Peer-based estimation across all platforms | | **Analytics** | Per-company hiring summaries | | **Output profiles** | Full / Compact / Minimal | ### Input reference | Field | Type | Default | Description | |---|---|---|---| | `careerUrls` | string\[] | required | Career page URLs or slugs | | `defaultPlatform` | enum | `""` | Fallback for plain slugs | | `includeDescription` | boolean | `true` | Include descriptions | | `includeQuestions` | boolean | `false` | Application questions (Greenhouse) | | `departmentFilter` | string | `""` | Filter by department | | `locationFilter` | string | `""` | Filter by location | | `maxJobsPerCompany` | integer | `0` | Limit per company | | `enableClassification` | boolean | `true` | Seniority + category + work mode | | `enableSkillsExtraction` | boolean | `false` | Skills taxonomy extraction | | `enableSalaryEstimation` | boolean | `false` | Peer-based salary estimation | | `enableChangeDetection` | boolean | `false` | Track changes between runs | | `deltaOnly` | boolean | `false` | Only output changes | | `deduplicateAcrossBoards` | boolean | `false` | Cross-platform dedup | | `includeAnalytics` | boolean | `false` | Per-company summaries | | `outputProfile` | enum | `"full"` | full / compact / minimal | ### Pricing **Pay Per Result: $3 per 1,000 jobs** ($0.003 per job). Premium over individual platform scrapers because it solves the routing problem — one input, all platforms. **Cost-saving tip**: Use `deltaOnly` on scheduled runs for 85-95% savings. ### Individual platform scrapers Need just one platform? Use our dedicated scrapers at lower cost ($2/1K): - **[Greenhouse ATS Job Scraper Pro](https://apify.com/maverickpoint/greenhouse-ats-scraper)** - **[Lever ATS Job Scraper Pro](https://apify.com/maverickpoint/lever-ats-scraper)** - **[Ashby ATS Job Scraper Pro](https://apify.com/maverickpoint/ashby-ats-scraper)** ### Feedback Found a bug? Open an issue on the **Issues** tab. # Actor input Schema ## `careerUrls` (type: `array`): Paste career page URLs or company slugs. The scraper auto-detects the ATS platform from the URL. Examples: - https://boards.greenhouse.io/stripe - https://jobs.lever.co/spotify - https://jobs.ashbyhq.com/notion You can also use plain slugs with defaultPlatform set. ## `defaultPlatform` (type: `string`): If you enter plain slugs instead of URLs, specify which platform to use. ## `includeDescription` (type: `boolean`): Include HTML + plain-text descriptions. ## `includeQuestions` (type: `boolean`): Include application form questions. Only available for Greenhouse jobs. ## `departmentFilter` (type: `string`): Only return jobs matching this department. ## `locationFilter` (type: `string`): Only return jobs matching this location. ## `maxJobsPerCompany` (type: `integer`): Limit per company. 0 = unlimited. ## `enableClassification` (type: `boolean`): Add seniority, category, and work mode to every job. Uses native ATS fields when available. ## `enableSkillsExtraction` (type: `boolean`): Parse descriptions to extract required vs. preferred skills using a 500-term taxonomy. ## `enableSalaryEstimation` (type: `boolean`): Estimate salary from peer data across all platforms in this run. ## `enableChangeDetection` (type: `boolean`): Mark each job as new, updated, removed, or unchanged. ## `deltaOnly` (type: `boolean`): Only output changes. Saves 85-95% on repeat runs. ## `deduplicateAcrossBoards` (type: `boolean`): Flag duplicate jobs across all companies and platforms. ## `includeAnalytics` (type: `boolean`): Per-company analytics summaries. ## `outputProfile` (type: `string`): Full: all fields. Compact: no HTML. Minimal: essentials only. ## Actor input object example ```json { "careerUrls": [ "https://boards.greenhouse.io/webflow", "https://jobs.lever.co/spotify", "https://jobs.ashbyhq.com/notion" ], "defaultPlatform": "", "includeDescription": true, "includeQuestions": false, "departmentFilter": "", "locationFilter": "", "maxJobsPerCompany": 0, "enableClassification": true, "enableSkillsExtraction": false, "enableSalaryEstimation": false, "enableChangeDetection": false, "deltaOnly": false, "deduplicateAcrossBoards": false, "includeAnalytics": false, "outputProfile": "full" } ``` # 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 = { "careerUrls": [ "https://boards.greenhouse.io/webflow", "https://jobs.lever.co/spotify", "https://jobs.ashbyhq.com/notion" ] }; // Run the Actor and wait for it to finish const run = await client.actor("maverickpoint/ats-universal-scraper").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 = { "careerUrls": [ "https://boards.greenhouse.io/webflow", "https://jobs.lever.co/spotify", "https://jobs.ashbyhq.com/notion", ] } # Run the Actor and wait for it to finish run = client.actor("maverickpoint/ats-universal-scraper").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 '{ "careerUrls": [ "https://boards.greenhouse.io/webflow", "https://jobs.lever.co/spotify", "https://jobs.ashbyhq.com/notion" ] }' | apify call maverickpoint/ats-universal-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maverickpoint/ats-universal-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ATS Universal Job Scraper", "description": "One scraper for all ATS platforms. Auto-detects Greenhouse, Lever, and Ashby from career URLs. Unified output with skills extraction, classification, change detection, and analytics across 20,000+ companies.", "version": "1.0", "x-build-id": "gIKKRfC4RWUQhNKh0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maverickpoint~ats-universal-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maverickpoint-ats-universal-scraper", "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/maverickpoint~ats-universal-scraper/runs": { "post": { "operationId": "runs-sync-maverickpoint-ats-universal-scraper", "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/maverickpoint~ats-universal-scraper/run-sync": { "post": { "operationId": "run-sync-maverickpoint-ats-universal-scraper", "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": [ "careerUrls" ], "properties": { "careerUrls": { "title": "Career Page URLs", "type": "array", "description": "Paste career page URLs or company slugs. The scraper auto-detects the ATS platform from the URL.\n\nExamples:\n- https://boards.greenhouse.io/stripe\n- https://jobs.lever.co/spotify\n- https://jobs.ashbyhq.com/notion\n\nYou can also use plain slugs with defaultPlatform set.", "items": { "type": "string" } }, "defaultPlatform": { "title": "Default Platform (for plain slugs)", "enum": [ "", "greenhouse", "lever", "ashby" ], "type": "string", "description": "If you enter plain slugs instead of URLs, specify which platform to use.", "default": "" }, "includeDescription": { "title": "Include Job Descriptions", "type": "boolean", "description": "Include HTML + plain-text descriptions.", "default": true }, "includeQuestions": { "title": "Include Application Questions (Greenhouse only)", "type": "boolean", "description": "Include application form questions. Only available for Greenhouse jobs.", "default": false }, "departmentFilter": { "title": "Filter by Department", "type": "string", "description": "Only return jobs matching this department.", "default": "" }, "locationFilter": { "title": "Filter by Location", "type": "string", "description": "Only return jobs matching this location.", "default": "" }, "maxJobsPerCompany": { "title": "Max Jobs Per Company", "minimum": 0, "type": "integer", "description": "Limit per company. 0 = unlimited.", "default": 0 }, "enableClassification": { "title": "Auto-Classify Jobs", "type": "boolean", "description": "Add seniority, category, and work mode to every job. Uses native ATS fields when available.", "default": true }, "enableSkillsExtraction": { "title": "Extract Skills & Technologies", "type": "boolean", "description": "Parse descriptions to extract required vs. preferred skills using a 500-term taxonomy.", "default": false }, "enableSalaryEstimation": { "title": "Estimate Missing Salaries", "type": "boolean", "description": "Estimate salary from peer data across all platforms in this run.", "default": false }, "enableChangeDetection": { "title": "Track Changes Between Runs", "type": "boolean", "description": "Mark each job as new, updated, removed, or unchanged.", "default": false }, "deltaOnly": { "title": "Delta Only", "type": "boolean", "description": "Only output changes. Saves 85-95% on repeat runs.", "default": false }, "deduplicateAcrossBoards": { "title": "Deduplicate Across Companies", "type": "boolean", "description": "Flag duplicate jobs across all companies and platforms.", "default": false }, "includeAnalytics": { "title": "Include Board Analytics", "type": "boolean", "description": "Per-company analytics summaries.", "default": false }, "outputProfile": { "title": "Output Profile", "enum": [ "full", "compact", "minimal" ], "type": "string", "description": "Full: all fields. Compact: no HTML. Minimal: essentials only.", "default": "full" } } }, "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 } } } } } } } } } } ```