{ "openapi": "3.0.1", "info": { "title": "Dice Jobs Scraper (US tech jobs)", "description": "Scrape Dice, the US tech job board, by posted date: above the site's 10,000-row limit a search is split automatically and what stays out of reach is counted. Each job with its full job page (description, skills, contract, apply link). Pay per job.", "version": "0.1", "x-build-id": "Wwugcf6wdRs5uO8ir" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hexagone-data~dice-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hexagone-data-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/hexagone-data~dice-jobs-scraper/runs": { "post": { "operationId": "runs-sync-hexagone-data-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/hexagone-data~dice-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-hexagone-data-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "One search per term, as typed in the site's 'Job title, skill, company, keyword' box (e.g. python developer, java, nurse). The filters below apply to these searches.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Dice search URLs exactly as your browser shows them, filters included: https://www.dice.com/jobs?q=python&location=Austin%2C+TX%2C+USA, the URL copied after clicking a job on the list (the search is read, not only that job), or https://www.dice.com/jobs/q-python-jobs. A URL whose page would turn it into a search of the whole site is rejected. A location the site does not understand (\"Anywhere\", a typo) filters nothing: each location is checked with two counts, the search with it and the same search without it (never charged); if they differ by at most 3 jobs or 0.2% (the site's totals move by a few jobs between requests), the URL is rejected if it has no words and no filter, read with a warning (LOCATION_NO_EFFECT) otherwise (the warning can be wrong for a small search whose jobs are all in that location). A search with a location also includes remote jobs, as on the site. Read in addition to the search terms; a URL keeps its own filters. A single job URL (/job-detail/..., or an old /jobs/detail/...) is not supported yet. A remote list of URLs is not supported.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum number of jobs", "minimum": 0, "type": "integer", "description": "Stops at exactly this number across all searches. Order: newest first within each search (and within each slice when a search is split above 10,000); jobs the site features come first on the first page. 0 = no limit.", "default": 20 }, "includeDetails": { "title": "Include the job page details", "type": "boolean", "description": "Reads each job's own page: full description, skills, postal code, contract types (W2, C2C, independent) and term, apply link or e-mail the page serves. Same price per job with or without; turn it off only to go faster.", "default": true }, "location": { "title": "Location (search terms)", "type": "string", "description": "As in the site's location box: a city (Austin, TX, USA) or a state (Texas). Empty = all of the US. For remote jobs, use Workplace types = Remote: \"Remote\" as a location filters nothing on Dice (typed here, \"Remote\", \"remote only\", \"Remote US\", \"Remote USA\", \"Remote - US\" or \"Remote (US)\" is turned into Workplace types = Remote, your other workplace types kept, and said in the run summary). Any location is checked with two counts, the search with it and without it (never charged): if they differ by at most 3 jobs or 0.2% (the site's totals move by a few jobs between requests), the location filtered nothing and the run summary warns (LOCATION_NO_EFFECT). A location also includes remote jobs, as on the site." }, "radiusMiles": { "title": "Radius in miles (search terms)", "enum": [ "10", "30", "50", "75" ], "type": "string", "description": "Around the location, as on the site. Empty = the site's default." }, "postedWithin": { "title": "Posted within (search terms)", "enum": [ "ONE", "THREE", "SEVEN" ], "type": "string", "description": "Empty = any date." }, "employmentTypes": { "title": "Employment types (search terms)", "type": "array", "description": "Several values = jobs of any of them, as on the site. Empty = all.", "items": { "type": "string", "enum": [ "FULLTIME", "PARTTIME", "CONTRACTS", "THIRD_PARTY" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Third party" ] } }, "workplaceTypes": { "title": "Workplace types (search terms)", "type": "array", "description": "Several values = jobs of any of them. Empty = all.", "items": { "type": "string", "enum": [ "On-Site", "Remote", "Hybrid" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] } }, "employerTypes": { "title": "Employer types (search terms)", "type": "array", "description": "Several values = jobs of any of them. Empty = all.", "items": { "type": "string", "enum": [ "Direct Hire", "Recruiter", "Other" ], "enumTitles": [ "Direct hire", "Recruiter", "Other" ] } }, "easyApplyOnly": { "title": "Easy Apply only (search terms)", "type": "boolean", "description": "Only jobs with the site's Easy Apply.", "default": false }, "willingToSponsorOnly": { "title": "Willing to sponsor only (search terms)", "type": "boolean", "description": "Only jobs whose employer is willing to sponsor a work visa.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. By default no proxy is used (no refusal measured); if the site refuses (HTTP 403 or 429, challenge page), the run retries, then falls back to Apify's datacenter proxy (US), then to Apify's residential proxy (US) for the search list only: job pages never use the residential proxy. Server errors (HTTP 5xx) are retried, never taken as a refusal. Set a proxy here to use it from the first request; turning the proxy off is respected." } } }, "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 } } } } } } } } } }