{ "openapi": "3.0.1", "info": { "title": "Dice Jobs Scraper", "description": "Collect Dice job listings in minutes with structured job data for recruiting, hiring research, and job market analysis. Start from ready made Dice search URLs or flexible filters, then export salaries, skills, apply links, company profiles, similar jobs, and other useful job details.", "version": "1.0", "x-build-id": "kXI6vwgrfKUrH3Xsv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~dice-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~dice-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~dice-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste one or more Dice search URLs with filters already applied when you want to scrape exactly what you see on the site.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "Paste a Dice jobs search URL such as a keyword, location, or filtered results page." } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Set the maximum total jobs to collect across the whole run. Free users are capped at 100, paid users up to 1,000,000." }, "maxItemsPerStartUrl": { "title": "Max Items Per Start URL", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Set the maximum jobs to collect from each URL inside startUrls. The actor still respects Max Items as the overall run limit." }, "query": { "title": "Query", "type": "string", "description": "Enter the job keyword you want to search for, such as python, devops, java, or data engineer." }, "location": { "title": "Location", "type": "string", "description": "Limit results to a city, metro, state, or region such as New York, NY, Reston, VA, or California." }, "radius": { "title": "Radius", "minimum": 0, "maximum": 500, "type": "integer", "description": "Choose how far from the selected location Dice should look for jobs." }, "radiusUnit": { "title": "Radius Unit", "enum": [ "mi", "km" ], "type": "string", "description": "Choose whether the search radius should use miles or kilometers." }, "employmentTypes": { "title": "Employment Types", "uniqueItems": true, "type": "array", "description": "Keep only the employment types you want, such as full-time, part-time, contract, or third-party roles.", "items": { "type": "string", "enum": [ "FULLTIME", "PARTTIME", "CONTRACTS", "THIRD_PARTY" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Third Party" ] } }, "employmentType": { "title": "Employment Type", "uniqueItems": true, "type": "array", "description": "Use this alternative field name if you are migrating from another Dice actor that expects employmentType.", "items": { "type": "string", "enum": [ "FULLTIME", "PARTTIME", "CONTRACTS", "THIRD_PARTY" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Third Party" ] } }, "workplaceTypes": { "title": "Workplace Types", "uniqueItems": true, "type": "array", "description": "Choose whether to keep on-site, remote, or hybrid jobs in the results.", "items": { "type": "string", "enum": [ "On-Site", "Remote", "Hybrid" ], "enumTitles": [ "On-Site", "Remote", "Hybrid" ] } }, "employerTypes": { "title": "Employer Types", "uniqueItems": true, "type": "array", "description": "Limit results to jobs posted by direct employers, recruiters, or other employer types.", "items": { "type": "string", "enum": [ "Direct Hire", "Recruiter", "Other" ], "enumTitles": [ "Direct Hire", "Recruiter", "Other" ] } }, "employerType": { "title": "Employer Type", "uniqueItems": true, "type": "array", "description": "Use this alternative field name if you are migrating from another Dice actor that expects employerType.", "items": { "type": "string", "enum": [ "Direct Hire", "Recruiter", "Other" ], "enumTitles": [ "Direct Hire", "Recruiter", "Other" ] } }, "postedDate": { "title": "Posted Date", "enum": [ "ONE", "THREE", "SEVEN" ], "type": "string", "description": "Focus on fresher jobs by limiting results to postings from today, the last 3 days, or the last 7 days." }, "easyApply": { "title": "Easy Apply Only", "type": "boolean", "description": "Turn this on to keep only jobs that support Dice Easy Apply." }, "isRemote": { "title": "Remote Only", "type": "boolean", "description": "Turn this on to keep only jobs that Dice marks as remote." }, "willingToSponsor": { "title": "Willing To Sponsor", "type": "boolean", "description": "Turn this on to keep only jobs that mention sponsorship willingness." }, "includeRemote": { "title": "Include Remote", "type": "boolean", "description": "Choose whether broader searches should also include remote jobs instead of only location-matched jobs." }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "datePosted" ], "type": "string", "description": "Sort results by relevance or by the most recently posted jobs first." }, "includeDetails": { "title": "Include Details", "type": "boolean", "description": "Turn this on to open each Dice job and collect richer detail fields like description, skills, image links, similar jobs, legal IDs, and extra metadata." } } }, "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 } } } } } } } } } }