{ "openapi": "3.0.1", "info": { "title": "Dice.com Jobs Scraper — Tech Hiring Feed", "description": "Search public Dice.com technology jobs. Get normalized titles, employers, locations, salary ranges, work settings, dates, descriptions, and direct job URLs for recruiting and job-market research.", "version": "1.2", "x-build-id": "8iUc703jHOGhtcjag" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~dice-com-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-dice-com-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/khadinakbar~dice-com-jobs-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-dice-com-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/khadinakbar~dice-com-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-dice-com-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": { "searchQuery": { "title": "Job search query", "type": "string", "description": "Use this when you want Dice jobs matching a role, skill, or company phrase. Enter plain text such as 'software engineer' or 'python developer'. Defaults to 'software engineer' and is URL-encoded for Dice search. This is NOT a Dice URL; use Start URLs to scrape an existing Dice page.", "default": "software engineer" }, "location": { "title": "Location", "type": "string", "description": "Use this when the Dice search should focus on a city, state, or remote work. Enter a value such as 'Austin, TX' or 'Remote'. Defaults to 'Remote' for the ready-to-run search. This is NOT a country code or an exact postal-address field.", "default": "Remote" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Use this when you already have a Dice search-results or job-detail URL to scrape exactly. Add full URLs such as 'https://www.dice.com/jobs?q=data%20engineer&location=Remote'. If empty, the actor builds one search from Job search query and Location. This is NOT for URLs from other job boards.", "items": { "type": "object", "properties": { "url": { "title": "Dice URL", "type": "string", "description": "A full Dice jobs or job-detail URL, for example 'https://www.dice.com/jobs?q=data%20engineer&location=Remote'." } }, "required": [ "url" ] }, "default": [] }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Use this to cap the total number of job records returned and billed. Choose an integer from 1 through 100; default is 10. Each persisted job costs $0.00125 plus platform usage. This is NOT a per-page or per-start-URL limit.", "default": 10 }, "postedWithin": { "title": "Posted within", "enum": [ "any", "today", "3days", "7days" ], "type": "string", "description": "Use this when you only want recently posted Dice jobs. Choose 'any', 'today', '3days', or '7days'; default is 'any'. The matching Dice search parameter is added to generated searches. This is NOT a guarantee that Dice exposes a timestamp for every listing.", "default": "any" }, "workplaceTypes": { "title": "Workplace types", "type": "array", "description": "Use this when you want Dice work-setting filters. Select any combination of 'Remote', 'Hybrid', and 'On-Site'; default is no work-setting filter. The actor also returns each job's published workplace type when available. This is NOT a location-radius filter.", "items": { "type": "string" }, "default": [] }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Use this when you want a Dice employment-type filter. Select any combination of 'Full-time', 'Part-time', 'Contract', and 'Third Party'; default is no employment filter. Records retain the type displayed by Dice. This is NOT an employer-source filter.", "items": { "type": "string" }, "default": [] }, "easyApplyOnly": { "title": "Easy Apply only", "type": "boolean", "description": "Use this when you only want listings that Dice labels Easy Apply. Set true to add the public filter or false to return all matching jobs. Defaults to false. This is NOT an instruction to submit an application or interact with applicant accounts.", "default": false }, "willingToSponsor": { "title": "Willing to sponsor only", "type": "boolean", "description": "Use this when you only want listings that Dice marks as willing to sponsor work authorization. Set true to add the public sponsorship filter or false to leave it off. Defaults to false. This is NOT legal or immigration advice.", "default": false }, "includeJobDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Use this to visit each public Dice detail page for a fuller description and direct application link. Defaults to true; set false for a faster card-level feed. Card-level records still contain core job fields. This is NOT a way to access login-only or applicant data.", "default": true }, "responseFormat": { "title": "Response format", "enum": [ "concise", "detailed" ], "type": "string", "description": "Use this to control description length for an AI-agent or analytics workflow. Choose 'concise' for a 1,000-character description or 'detailed' for up to 5,000 characters; default is 'concise'. Both formats retain the same normalized job fields. This is NOT a CSV, JSON, or download-format option.", "default": "concise" } } }, "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 } } } } } } } } } }