# ADP Jobs Scraper (`fetch_cat/adp-jobs-scraper`) Actor Extract public job postings from ADP Workforce Now career centers. - **URL**: https://apify.com/fetch\_cat/adp-jobs-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Jobs, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 adp job saveds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## ADP Jobs Scraper Extract public job postings from ADP Workforce Now career centers on `workforcenow.adp.com`. This jobs and recruiting data scraper turns public ADP career-center URLs into structured job rows for recruiting intelligence, job-board backfills, market research, and hiring monitors. ### At a glance - **Primary job**: Collect current public ADP Workforce Now job postings without browser automation or credentials. - **Input**: Public ADP recruitment page URLs or public ADP job-requisitions API URLs containing `cid`. - **Output**: One dataset row per job with title, requisition IDs, location, dates, job URL, tenant identifiers, and optional raw ADP JSON. - **Best for**: Recruiting intelligence, competitor hiring tracking, job-board sourcing, lead generation, and scheduled monitoring. ### Common workflows - **Backfill ADP-hosted openings**: Export all current jobs from an employer's public ADP career center. - **Monitor hiring changes**: Schedule repeat runs for the same ADP tenants and compare dataset exports over time. - **Feed recruiting systems**: Send requisition IDs, job URLs, titles, and locations into spreadsheets, CRMs, data warehouses, or automation tools. - **Validate source URLs**: Keep `emitErrorItems` enabled to receive stable diagnostic rows for missing `cid`, unsupported URLs, empty tenants, or unexpected responses. ### Input recipes - **Small smoke test**: Use the default ADP URL with `maxItems: 20` and `includeRaw: true`. - **Direct API URL**: Paste a public ADP `job-requisitions` URL and set `includeRaw: false` for a compact dataset. - **Multi-company monitor**: Add several public ADP career-center URLs to `startUrls`, keep `maxItems` bounded, and schedule the run. ### What data can you extract? | Field | Description | | --- | --- | | `itemType` | `job` for job rows or `error` for diagnostic rows. | | `jobId` | ADP job item ID. | | `clientRequisitionId` | Employer/client requisition identifier. | | `externalJobId` | External job ID when ADP exposes it. | | `title` | Public job title. | | `companyName` | Company name when included by ADP. | | `careerCenterUrl` | Canonical ADP career-center URL for the tenant. | | `jobUrl` | Canonical public job URL including the ADP job ID. | | `sourceUrl` | Original input URL. | | `cid`, `ccId`, `lang` | ADP tenant/career-center/language identifiers. | | `postDate`, `currentServerDate` | Raw public ADP date values. | | `locationText`, `city`, `region`, `postalCode`, `country` | Location text and normalized location parts. | | `workLevel`, `jobClass`, `department` | Common ADP classification fields. | | `isInternalPosting` | Internal-posting flag when exposed. | | `expectedTotal`, `returnedCount` | Count diagnostics from the ADP response. | | `rawRequisition` | Original ADP requisition object when `includeRaw` is enabled. | | `errorCode`, `errorMessage` | Stable diagnostics for invalid or unsupported inputs. | ### Input configuration | Setting | JSON key | Use it for | Example | | --- | --- | --- | --- | | ADP career center URLs | `startUrls` | Public ADP Workforce Now recruitment or job-requisitions URLs. | `https://workforcenow.adp.com/...recruitment.html?cid=...` | | Maximum jobs | `maxItems` | Cap saved job rows and control spend. | `20` | | Include raw ADP requisition | `includeRaw` | Preserve the original source object for fields not yet normalized. | `true` | | Emit error rows | `emitErrorItems` | Save diagnostic rows for bad inputs, empty tenants, and non-JSON responses. | `true` | ### Example input ```json { "startUrls": [ { "url": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US" } ], "maxItems": 20, "includeRaw": true, "emitErrorItems": true } ```` ### Example output ```json { "itemType": "job", "jobId": "9201203789874_1", "clientRequisitionId": "2833", "externalJobId": "595246", "title": "Cybersecurity Compliance Engineer", "careerCenterUrl": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?cid=070b2b3d-d077-4d73-b340-6055055056a6&ccId=19000101_000001&lang=en_US", "jobUrl": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?cid=070b2b3d-d077-4d73-b340-6055055056a6&ccId=19000101_000001&lang=en_US&jobId=9201203789874_1", "sourceUrl": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US", "cid": "070b2b3d-d077-4d73-b340-6055055056a6", "ccId": "19000101_000001", "lang": "en_US", "postDate": "2026-07-13T09:26:00.000-04:00", "locationText": "Philadelphia, Philadelphia, PA, US", "city": "Philadelphia", "region": "PA", "postalCode": "19114", "country": "US", "workLevel": "Regular Full-Time", "jobClass": "Professional", "department": "", "isInternalPosting": false, "expectedTotal": 23, "returnedCount": 20, "scrapedAt": "2026-07-16T10:00:54.791Z" } ``` ### Pricing | Event | Free | Bronze | Silver | Gold | Platinum | Diamond | Charged when | | --- | ---: | ---: | ---: | ---: | ---: | ---: | --- | | Run start | `$0.005` | `$0.005` | `$0.005` | `$0.005` | `$0.005` | `$0.005` | Once when the Actor starts. | | Job item | `$0.00115` | `$0.00100` | `$0.00078` | `$0.00060` | `$0.00040` | `$0.00028` | Each real job row saved to the dataset. Diagnostic error rows are not charged as jobs. | Pricing uses Apify Store discount tiers and will be recalculated from final cloud cost measurements before publication if needed. ### Tips for best results - **Use public ADP URLs**: Open the URL in a private browser window first. If the job list is public, the Actor can usually process it. - **Keep examples small**: Start with `maxItems: 20` until you confirm the output shape for a tenant. - **Keep raw data when exploring**: Leave `includeRaw: true` for first runs so you can inspect source fields beyond the normalized columns. - **Check diagnostics**: If a row has `itemType=error`, inspect `errorCode` and `errorMessage` before retrying. ### Limits and responsible use This Actor collects public job postings only. It does not log in, submit applications, access applicant profiles, retrieve candidate data, or use employer/admin sessions. Make sure your use follows ADP's terms, the target employer's terms, and applicable laws. ### API usage Node.js: ```js import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor("fetch_cat/adp-jobs-scraper").call({ startUrls: [{ url: "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US" }], maxItems: 20, includeRaw: true, emitErrorItems: true }); console.log(run.defaultDatasetId); ``` Python: ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("fetch_cat/adp-jobs-scraper").call(run_input={ "startUrls": [{"url": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US"}], "maxItems": 20, "includeRaw": True, "emitErrorItems": True, }) print(run["defaultDatasetId"]) ``` cURL: ```bash curl -X POST "https://api.apify.com/v2/acts/fetch_cat~adp-jobs-scraper/runs?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"startUrls":[{"url":"https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US"}],"maxItems":20,"includeRaw":true,"emitErrorItems":true}' ``` ### MCP and AI agents Use this Actor from MCP-compatible tools through the official Apify MCP Server. ```bash claude mcp add --transport http apify "https://mcp.apify.com?tools=fetch_cat/adp-jobs-scraper" ``` MCP JSON configuration: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=fetch_cat/adp-jobs-scraper" } } } ``` Tool input: ```json { "startUrls": [ { "url": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US" } ], "maxItems": 20, "includeRaw": true, "emitErrorItems": true } ``` Example prompts: - "Run ADP Jobs Scraper for this public ADP career-center URL and summarize the job titles by location." - "Extract up to 50 public ADP jobs and return a table with title, requisition ID, post date, and job URL." ### Related Actors - [LinkedIn Jobs Scraper](https://apify.com/fetch_cat/linkedin-jobs-scraper) - [Indeed Scraper](https://apify.com/fetch_cat/indeed-scraper) - [Google Jobs Scraper](https://apify.com/fetch_cat/google-jobs-scraper) ### FAQ **Does this Actor need ADP credentials?** No. It is designed for public ADP Workforce Now career-center postings only. **Can it submit applications or collect applicant profiles?** No. Application flows, candidate profiles, documents, and employer/admin pages are outside this Actor's scope. **Why did I get an `MISSING_CID` error?** The input URL does not include ADP's public `cid` tenant parameter. Copy the full ADP career-center URL from the browser address bar. **Why are there fewer rows than `expectedTotal`?** ADP may report the tenant total separately from the returned page. The Actor keeps the available public rows and records `expectedTotal` and `returnedCount` for diagnostics. ### Support If you need help, open an issue on the Actor page and include: - the run ID, - the input JSON you used, - a reproducible public URL (the full public ADP career-center URL), - the expected output, - the actual output, - any diagnostic `errorCode` or `errorMessage` from the dataset. # Actor input Schema ## `startUrls` (type: `array`): Public ADP Workforce Now recruitment pages or public ADP job-requisitions API URLs containing cid and, when available, ccId/lang. ## `maxItems` (type: `integer`): Maximum number of job rows to save across all input URLs. Error diagnostic rows are not charged as jobs. ## `includeRaw` (type: `boolean`): Include the original ADP requisition object in rawRequisition so you can access fields that are not yet normalized. ## `emitErrorItems` (type: `boolean`): Save input-level diagnostic rows for invalid URLs, unsupported tenants, empty tenants, and non-JSON responses. ## Actor input object example ```json { "startUrls": [ { "url": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US" } ], "maxItems": 20, "includeRaw": true, "emitErrorItems": true } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "startUrls": [ { "url": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US" } ], "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/adp-jobs-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 = { "startUrls": [{ "url": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US" }], "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/adp-jobs-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 '{ "startUrls": [ { "url": "https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?ccId=19000101_000001&cid=070b2b3d-d077-4d73-b340-6055055056a6&lang=en_US" } ], "maxItems": 20 }' | apify call fetch_cat/adp-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/adp-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ADP Jobs Scraper", "description": "Extract public job postings from ADP Workforce Now career centers.", "version": "0.1", "x-build-id": "bfnelfNROkKJxlQfP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~adp-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-adp-jobs-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/fetch_cat~adp-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-adp-jobs-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/fetch_cat~adp-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-adp-jobs-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": [ "startUrls" ], "properties": { "startUrls": { "title": "ADP career center URLs", "type": "array", "description": "Public ADP Workforce Now recruitment pages or public ADP job-requisitions API URLs containing cid and, when available, ccId/lang.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of job rows to save across all input URLs. Error diagnostic rows are not charged as jobs.", "default": 20 }, "includeRaw": { "title": "Include raw ADP requisition", "type": "boolean", "description": "Include the original ADP requisition object in rawRequisition so you can access fields that are not yet normalized.", "default": true }, "emitErrorItems": { "title": "Emit error rows", "type": "boolean", "description": "Save input-level diagnostic rows for invalid URLs, unsupported tenants, empty tenants, and non-JSON responses.", "default": true } } }, "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 } } } } } } } } } } ```