{ "openapi": "3.0.1", "info": { "title": "Dice Jobs Scraper", "description": "Scrape open tech roles from Dice.com's public job search: title, employer, location, employment type, salary (where posted), posted date and apply URL. Give it a keyword query. No login, no account.", "version": "1.0", "x-build-id": "gneIny3HlGpPlsSUi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zilicon~dice-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zilicon-dice-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/zilicon~dice-jobs-scraper/runs": { "post": { "operationId": "runs-sync-zilicon-dice-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/zilicon~dice-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-zilicon-dice-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": { "keywords": { "title": "Search keywords", "type": "string", "description": "What to search Dice for, e.g. 'software developer', 'java', 'data engineer'. This is sent to Dice's own search (?q=), so it returns the same roles the site would. Leave blank to return the newest roles across all of Dice." }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many roles. Your cost control. Dice returns 32 roles per page, so 100 walks about 4 pages. Set 0 for no cap (walks until the last result page).", "default": 100 }, "titleOnly": { "title": "Match title only", "type": "boolean", "description": "Keep only roles whose TITLE contains all of your keywords. Dice ranks by relevance and may return loosely related roles; turn this on to keep only titles that actually name your terms.", "default": false }, "excludeKeywords": { "title": "Exclude keywords", "type": "string", "description": "Drop any role containing ANY of these words, e.g. 'senior manager clearance'. Applied to the title, company and workplace type. Useful for stripping seniority or terms you do not want." }, "location": { "title": "Location filter", "type": "string", "description": "Keep only roles whose location contains ALL of these words, e.g. 'remote' or 'new york'. Dice serves the full location on the job detail page, so this filter needs 'Fetch job details' on (the default). A role that was not enriched has no location and is dropped when this filter is set." }, "remoteOnly": { "title": "Remote roles only", "type": "boolean", "description": "Keep only remote roles. Uses the workplace-type badge on the search card plus the detail-page location, so it is most accurate with 'Fetch job details' on.", "default": false }, "fetchDetails": { "title": "Fetch job details", "type": "boolean", "description": "Open each role's detail page to fill in location, employment type, salary (where Dice publishes it), posted date and a short description. This is a free extra page fetch per role - it makes the location filter work and the output far richer. Turn off only for a fast title/company-only listing scrape.", "default": true }, "maxDetail": { "title": "Max detail fetches", "minimum": 0, "type": "integer", "description": "Cap how many roles get their detail page fetched. 0 (the default) enriches every returned role. Set a number to enrich only the first N and keep the rest listing-only - a way to bound runtime on a very large scrape.", "default": 0 }, "detailConcurrency": { "title": "Detail fetch concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many detail pages to fetch in parallel. Leave the default unless a run is being rate-limited.", "default": 5 }, "maxPages": { "title": "Max pages", "minimum": 1, "type": "integer", "description": "Hard cap on how many search pages to walk, as a safety limit for a very broad query. Dice returns 32 roles per page. Leave the default unless you know you need more.", "default": 200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy configuration. Datacenter proxies are fine for Dice.", "default": { "useApifyProxy": 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 } } } } } } } } } }