{ "openapi": "3.0.1", "info": { "title": "Jobs API: Search 168k Company Jobs, No Board URLs Needed", "description": "Search 168,000 jobs from company career pages by words, location and remote. No board URLs, no company list, no key. 31 fields. $1 per 1,000.", "version": "0.1", "x-build-id": "OJ0SbI98PazhemNDU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dododata~job-search-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dododata-job-search-api", "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~job-search-api/runs": { "post": { "operationId": "runs-sync-dododata-job-search-api", "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~job-search-api/run-sync": { "post": { "operationId": "run-sync-dododata-job-search-api", "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": { "query": { "title": "Search words", "type": "string", "description": "What to search for in the job, for example \"data engineer\", \"product manager\", \"nurse\". Leave empty to take everything and narrow with the filters below." }, "location": { "title": "Location", "type": "string", "description": "A city, region or country as you would type it into a job site, for example London, Berlin, Texas. Leave empty for everywhere. For remote jobs use Workplace, not this field: the word Remote here is read as a place, and there is a Remote in Oregon." }, "workplace": { "title": "Workplace", "enum": [ "any", "remote", "hybrid", "on_site" ], "type": "string", "description": "Filter on how the job is worked. There are about 48,000 remote jobs in the index at the moment.", "default": "any" }, "dayRange": { "title": "Posted within (days)", "minimum": 1, "type": "integer", "description": "Keep only jobs posted in the last N days. Use 1 with a daily schedule for a feed of brand-new jobs." }, "titleKeywords": { "title": "Title must contain", "type": "array", "description": "Narrow further: keep only jobs whose TITLE contains one of these words or phrases, as whole words (accents and case ignored), so art matches Art Director and not Part-Time. Applied before a row is saved, so you do not pay for the rest.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Title must not contain", "type": "array", "description": "Drop jobs whose title contains one of these words, as whole words, for example senior, intern, internship, unpaid. Whole words means intern does not drop Internal Communications Manager, so list internship too if you want it gone.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Keep only jobs in these countries, for example United States, UK, Germany. Whole country names, matched against the job's country, so UK never matches Ukraine and Georgia the US state is not Georgia the country. US, USA, UK, GB and UAE are understood; England, Scotland, Wales and Northern Ireland match their own jobs.", "items": { "type": "string" } }, "onlyWithSalary": { "title": "Only jobs that state pay", "type": "boolean", "description": "Keep only jobs where a pay range could be read out of the job text. Workable publishes no salary field, so this depends on the employer writing one in the description.", "default": false }, "includeDescription": { "title": "Include descriptions", "type": "boolean", "description": "Turn off for lighter rows when you only need titles, companies, locations and links.", "default": true }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Turns on change tracking. Pick any name, for example remote-pm-watch, and use the same name on every run. Each job then says whether it is new, updated or already delivered, with the date it was first seen. The first run marks everything new. State is kept in a key-value store on your own Apify account, and each Actor keeps its own." }, "onlyChanges": { "title": "Only changes", "type": "boolean", "description": "Needs a monitor name. Jobs you already received are left out of the results and not billed. A daily run on a busy search usually returns a handful of rows instead of hundreds.", "default": false }, "maxItems": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Stop after this many jobs. You pay per row, so this is also your budget cap.", "default": 500 }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Kept for compatibility. The search pages one after another, because each page's token comes from the last, so this does not change speed.", "default": 5 }, "useProxy": { "title": "Use Apify proxy", "type": "boolean", "description": "Off by default: Workable's public search endpoint answered 2.4 times cheaper without it (5 s against 11 s for 120 jobs, 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 } } } } } } } } } }