{ "openapi": "3.0.1", "info": { "title": "Career Site Jobs Scraper & API: 12 ATS, One JSON Shape", "description": "One job board API across 12 applicant tracking systems. Paste a career page URL, get 30 fields per job in one shape, no key. Monitor returns only changes.", "version": "0.1", "x-build-id": "s2XbjxaBwyEyYMjfa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dododata~career-site-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dododata-career-site-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/dododata~career-site-jobs-scraper/runs": { "post": { "operationId": "runs-sync-dododata-career-site-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/dododata~career-site-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-dododata-career-site-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", "properties": { "startUrls": { "title": "Career page URLs", "type": "array", "description": "Career pages hosted on Greenhouse, Lever, Ashby, SmartRecruiters, Recruitee, Workable, Personio, Breezy, Pinpoint, Rippling, Teamtailor or Workday. For example: https://jobs.lever.co/spotify, https://job-boards.greenhouse.io/duolingo, https://jobs.ashbyhq.com/ramp, https://nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite. Any page of the board works; the company is read from the URL. Leave empty to try the Actor on three sample boards.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "companies": { "title": "Companies (names or short form)", "type": "array", "description": "Alternative to URLs. A bare company name, for example stripe or notion, is looked up on the nine systems where a name is enough (Greenhouse, Lever, Ashby, SmartRecruiters, Workable, Recruitee, Breezy, Pinpoint, Rippling) and read wherever it has open jobs; the log says where it was found. To pin one system use ats:company, for example greenhouse:stripe, lever:palantir, ashby:openai, smartrecruiters:BoschGroup, personio:personio.de, teamtailor:career.teamtailor.com, workday:nvidia.wd5/NVIDIAExternalCareerSite", "items": { "type": "string" } }, "keywords": { "title": "Title keywords", "type": "array", "description": "Keep only jobs whose title has a word starting with one of these (case and accents ignored), e.g. engineer, data, product: engineer finds Engineering Manager, art does not find Part-Time. Filtered-out jobs are not saved and not charged.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep only jobs whose location, country or workplace type contains one of these as a whole word, e.g. london, germany, remote. UK, US and USA are understood both ways, and UK never matches Ukraine.", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "type": "integer", "description": "Keep only jobs first published (or updated, when no publish date exists) in the last N days. Use 1 with a daily schedule to get only new jobs." }, "includeDescription": { "title": "Include descriptions", "type": "boolean", "description": "Turn off for lighter rows when you only need titles, locations and pay.", "default": true }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Turns on change tracking. Pick any name, for example my-job-watch, and use the same name on every run. Each job then says whether it is new, updated or unchanged since the previous run under that name, with the date it was first seen. The first run marks everything as new. State is kept in a key-value store on your own account. Leave empty to switch tracking off." }, "onlyChanges": { "title": "Only changes", "type": "boolean", "description": "Needs a monitor name. Unchanged jobs are left out of the results and are not billed. On systems that are read job by job (Workday, SmartRecruiters), unchanged jobs are not even opened, so runs get faster as well as cheaper.", "default": false }, "includeRemoved": { "title": "Report closed jobs", "type": "boolean", "description": "Needs a monitor name. A job that was listed in the previous run and is gone now is returned once, with change_status \"removed\", its title, URL and the dates it was first and last seen. Only reported when the board was read completely, so a filter or a row cap never produces a false alarm.", "default": true }, "maxItems": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Stop after this many jobs across all boards. You pay per row, so this is also your budget cap.", "default": 500 }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel requests. 5 is polite and fast enough for most sites.", "default": 5 }, "useProxy": { "title": "Use Apify proxy", "type": "boolean", "description": "Off by default: these job board APIs and career sites are public and answered four to eight times faster without a proxy in our measurements (25 Sept 2026). Turn it on only if a run reports being rate-limited or blocked.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }