{
"openapi": "3.0.1",
"info": {
"title": "Dice Jobs Scraper",
"description": "Scrape Dice (dice.com) US tech jobs and IT contracts: title, company, recruiter or direct employer, contract, C2C or full-time, W2 terms, remote or hybrid, salary or hourly rate, skills and full description. Search by keyword and city. Export to JSON, CSV or Excel, or via API.",
"version": "1.0",
"x-build-id": "FXP59Xi8iqi8UQ0Qg"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/steadyscrape~dice-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-steadyscrape-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/steadyscrape~dice-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-steadyscrape-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/steadyscrape~dice-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-steadyscrape-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": "Keywords (skills, roles or titles)",
"type": "array",
"description": "What people type into Dice's search box: Java, Python Developer, DevOps, Data Engineer, SAP, C++, Salesforce. Each keyword is read through Dice's own page for it (dice.com/jobs/q-java-jobs). Hyphens are read as spaces (\"front-end\" as \"front end\"), because Dice's pages split words at hyphens.",
"default": [],
"items": {
"type": "string"
}
},
"locations": {
"title": "Locations",
"type": "array",
"description": "A US city (Dallas, Dallas, TX), a state (Texas), a city with its ZIP code (Beverly Hills, CA 90210), a Canadian or UK city, or Remote for remote jobs anywhere. Each keyword is searched in each location. Dice also lists remote jobs in every place search, as its own site does. A place Dice does not recognise gives a free row saying so, instead of jobs from everywhere. Leave empty to search the whole US.",
"default": [],
"items": {
"type": "string"
}
},
"searchUrls": {
"title": "Dice search links",
"type": "array",
"description": "Searches copied from dice.com, with their filters: https://www.dice.com/jobs/q-java-l-texas-jobs?filters.employmentType=CONTRACTS or https://www.dice.com/jobs?q=java&location=Texas&filters.postedDate=ONE. A keyword search link is read through Dice's page for the same keyword and place (its robots.txt closes the search page itself to crawlers).",
"default": [],
"items": {
"type": "string"
}
},
"employmentTypes": {
"title": "Employment types",
"type": "array",
"description": "Dice's own employment type filter. Each type chosen is searched as its own list (Dice shows at most 500 jobs of one search), and a job listed under two types is delivered once. \"Third Party\" is a job a corp-to-corp (C2C) contractor may take. Leave empty for all types in one list.",
"items": {
"type": "string",
"enum": [
"CONTRACTS",
"THIRD_PARTY",
"FULLTIME",
"PARTTIME"
],
"enumTitles": [
"Contract",
"Third Party (C2C)",
"Full-time",
"Part-time"
]
},
"default": []
},
"employerType": {
"title": "Employer type",
"enum": [
"any",
"direct",
"recruiter"
],
"type": "string",
"description": "Direct employers only, staffing firms and recruiters only, or both.",
"default": "any"
},
"workplaceTypes": {
"title": "Workplace types",
"type": "array",
"description": "Remote, hybrid or on-site jobs, through Dice's own filter. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"remote",
"hybrid",
"on_site"
],
"enumTitles": [
"Remote",
"Hybrid",
"On-site"
]
},
"default": []
},
"postedWithin": {
"title": "Posted within",
"enum": [
"any",
"1",
"3",
"7"
],
"type": "string",
"description": "Dice's own posted date filter.",
"default": "any"
},
"willingToSponsor": {
"title": "Only employers willing to sponsor a visa",
"type": "boolean",
"description": "Dice's \"Willing to Sponsor\" filter.",
"default": false
},
"radiusMiles": {
"title": "Distance around a city",
"enum": [
"10",
"30",
"50",
"75"
],
"type": "string",
"description": "Miles around each location (Dice searches 30 by default).",
"default": "30"
},
"minHourlyRate": {
"title": "Minimum hourly rate",
"minimum": 0,
"type": "integer",
"description": "For contracts: jobs whose pay reaches this rate an hour. A yearly salary is counted at 2,080 hours a year unless a minimum yearly salary is also set. Jobs without a pay in figures (\"Depends on Experience\") are left out when it is set. Left-out jobs are not charged."
},
"minYearlySalary": {
"title": "Minimum yearly salary",
"minimum": 0,
"type": "integer",
"description": "For full-time jobs: jobs whose pay reaches this salary a year (an hourly rate counted at 2,080 hours, unless a minimum hourly rate is also set, which then applies to hourly pay)."
},
"onlyWithSalary": {
"title": "Only jobs with a pay in figures",
"type": "boolean",
"description": "Leaves out jobs whose card shows no pay, or only words such as \"Depends on Experience\" or \"DOE\".",
"default": false
},
"includeDetails": {
"title": "Include job details",
"type": "boolean",
"description": "On by default: opens each job's page for the full description, the skills, the contract terms (W2, Corp-to-Corp, Independent and the contract length), the date Dice lists the job until, the postal code and the employer's own job reference. Charged as job-with-details; off, each job is charged as job.",
"default": true
},
"maxJobsPerSearch": {
"title": "Max jobs per search",
"minimum": 0,
"type": "integer",
"description": "Per keyword, location and employment type. 0 for every job Dice shows (at most 500 a search: Dice shows 25 pages of 20).",
"default": 100
},
"onlyNewJobs": {
"title": "Only new jobs since the last run",
"type": "boolean",
"description": "Monitor mode for scheduled runs: jobs an earlier run with the same searches and filters delivered are skipped and not charged.",
"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
}
}
}
}
}
}
}
}
}
}