{ "openapi": "3.0.1", "info": { "title": "Dice Scraper — Tech Jobs, Salaries & Companies", "description": "Scrape Dice.com tech jobs by keyword, location, filters or URL: title, company, location, remote/hybrid, employment type, salary range, posted date; optional full description, skills, recruiter.", "version": "0.1", "x-build-id": "wLOXqTRrhErDIUyPD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tortuga~dice-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tortuga-dice-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/tortuga~dice-scraper/runs": { "post": { "operationId": "runs-sync-tortuga-dice-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/tortuga~dice-scraper/run-sync": { "post": { "operationId": "run-sync-tortuga-dice-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": "Keywords (job title, skill or company)", "type": "array", "description": "One search per keyword, e.g. \"python developer\", \"data engineer\", \"java\". Leave empty to list every job matching the location and filters.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Where, as you would type it on Dice: a city (\"Austin, TX\"), a state (\"California\"), or a ZIP code (\"10001\"). Leave empty for the whole US. \"Remote\" = remote jobs only." }, "radius": { "title": "Radius (miles)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Distance around a city or ZIP code. Dice's default is 30 miles; the site offers 10, 30, 50 and 75. Ignored for states and without a location." }, "postedDate": { "title": "Posted in the last", "enum": [ "", "ONE", "THREE", "SEVEN" ], "type": "string", "description": "Only jobs posted (or refreshed) within this period.", "default": "" }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Only these employment types. Several = any of them.", "items": { "type": "string", "enum": [ "FULLTIME", "CONTRACTS", "PARTTIME", "THIRD_PARTY" ], "enumTitles": [ "Full-time", "Contract", "Part-time", "Third party" ] } }, "workplaceTypes": { "title": "Workplace", "type": "array", "description": "Only remote, hybrid or on-site jobs. Several = any of them.", "items": { "type": "string", "enum": [ "Remote", "Hybrid", "On-Site" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] } }, "employerTypes": { "title": "Employer type", "type": "array", "description": "Direct employers, recruiting agencies or other. Several = any of them.", "items": { "type": "string", "enum": [ "Direct Hire", "Recruiter", "Other" ], "enumTitles": [ "Direct hire", "Recruiter", "Other" ] } }, "easyApplyOnly": { "title": "Easy Apply only", "type": "boolean", "description": "Only jobs you can apply to on Dice with Easy Apply.", "default": false }, "willingToSponsorOnly": { "title": "Willing to sponsor only", "type": "boolean", "description": "Only jobs whose employer is willing to sponsor a work visa.", "default": false }, "companyName": { "title": "Company", "type": "string", "description": "Only jobs from this company, exactly as Dice shows the name (e.g. \"Amazon Web Services, Inc.\")." }, "includeRemote": { "title": "Include remote jobs in location searches", "type": "boolean", "description": "Dice adds remote jobs from anywhere to a city or state search (as on the site). Turn off to get only jobs in or near the location.", "default": true }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Relevance (Dice's default) or newest first.", "default": "relevance" }, "startUrls": { "title": "Start URLs (Dice search or job pages)", "type": "array", "description": "Optional: Dice search URLs with any filters set on the site, e.g. https://www.dice.com/jobs?q=python&location=Austin,%20TX&filters.employmentType=CONTRACTS, or single job URLs (https://www.dice.com/job-detail/), which are returned with full details.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max jobs", "minimum": 1, "type": "integer", "description": "Stop after this many jobs in total (you pay per job saved).", "default": 100 }, "maxItemsPerSearch": { "title": "Max jobs per search", "minimum": 1, "type": "integer", "description": "Optional cap for each keyword / start URL, so one search does not use the whole Max jobs budget." }, "splitLargeSearches": { "title": "Get more than Dice's 10,000 results per search", "type": "boolean", "description": "Dice shows at most 10,000 jobs for any search. With this on, a bigger search is split by employer type, Easy Apply, remote, employment type and US state (and read in both sort orders when a slice is still too big), so you get far more of its jobs. Each extra page is one small request.", "default": true }, "includeDetails": { "title": "Include full job description", "type": "boolean", "description": "Open each job page for the full description (text and HTML), skills, contract types (W2, C2C...) and term, travel, Dice position id, postal code, expiry date and the recruiter shown on the page. One extra request and one 'detail' event per job.", "default": false }, "onlyNewOrChanged": { "title": "Only new or changed items", "type": "boolean", "description": "Remember what earlier runs of this search returned and output only new jobs or jobs whose title or pay text changed. Use with a Schedule; unchanged jobs are not charged. With this on, Max jobs is the number of jobs checked per run; sort by date to watch the newest jobs.", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Name for this watch, so several schedules on the same search stay separate; defaults to a key derived from the search input" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy (the default) works: Dice's search API and job pages do not block it. A page of 100 jobs is about 0.15 MB; a job page about 0.25 MB.", "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 }, "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 } } } } } } } } } }