{ "openapi": "3.0.1", "info": { "title": "Dice Jobs, With the Salary Bands Marked", "description": "Tech job adverts from dice.com with every salary labelled as either the employer's own figure or one of Dice's five salary bands. About one advert in five publishes a band edge in the salary field, and it reads exactly like a real wage.", "version": "0.1", "x-build-id": "fF7h3bTdeTX5O25t9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gubidonius~dice-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gubidonius-dice-jobs", "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/gubidonius~dice-jobs/runs": { "post": { "operationId": "runs-sync-gubidonius-dice-jobs", "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/gubidonius~dice-jobs/run-sync": { "post": { "operationId": "run-sync-gubidonius-dice-jobs", "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", "required": [ "maxResults" ], "properties": { "location": { "title": "Place", "type": "string", "description": "A place in dice.com's own form, for example \"Austin, TX, USA\". A place dice.com cannot resolve is NOT refused and does NOT return zero: it returns the entire unfiltered board, about 111,000 adverts from everywhere, labelled as a search for that place. This Actor checks the returned total against the unfiltered board and stops the run rather than writing them. Leave empty for the whole board.", "default": "" }, "radius": { "title": "Radius", "minimum": 1, "maximum": 500, "type": "integer", "description": "Distance around the place. Measured as real: Austin returned 12,913 adverts at 5 and 13,968 at 100. Ignored when no place is given.", "default": 30 }, "radiusUnit": { "title": "Radius unit", "enum": [ "mi", "km" ], "type": "string", "description": "Unit for the radius above.", "default": "mi" }, "postedDate": { "title": "Posted within", "enum": [ "", "ONE", "THREE", "SEVEN" ], "type": "string", "description": "How recent the advert is. dice.com offers these three windows and nothing else, so there is no \"last 30 days\".", "default": "" }, "employmentType": { "title": "Contract type", "enum": [ "", "FULLTIME", "PARTTIME", "CONTRACTS", "THIRD_PARTY" ], "type": "string", "description": "dice.com takes the value, not the label. Sending \"Full-time\" instead of FULLTIME returns 0 adverts rather than an error, which is why this is a list and not a text box. An advert can carry more than one contract type, so these counts add up to more than the board.", "default": "" }, "employerType": { "title": "Who is advertising", "enum": [ "", "Direct Hire", "Recruiter", "Other" ], "type": "string", "description": "Whether the advert comes from the employer or an agency. On 2026-09-16 the board held 84,696 direct, 19,668 recruiter and 7,318 other, which adds up to the board exactly, so this is the one filter you can use to cut the board into parts that do not overlap.", "default": "" }, "workplaceTypes": { "title": "Workplace", "enum": [ "", "On-Site", "Remote", "Hybrid" ], "type": "string", "description": "Use this for remote work. dice.com also publishes a field called \"work from home available\", which counts 450 adverts against 10,706 remote and cannot be filtered on at all.", "default": "" }, "easyApply": { "title": "Easy apply only", "enum": [ "", "true", "false" ], "type": "string", "description": "Adverts you can apply to without leaving dice.com. 21,109 of 111,682 on 2026-09-16.", "default": "" }, "willingToSponsor": { "title": "Visa sponsorship offered", "enum": [ "", "true", "false" ], "type": "string", "description": "Employers who said they will sponsor a visa. A small and specific part of the board: 1,163 adverts of 111,682 on 2026-09-16.", "default": "" }, "maxResults": { "title": "How many adverts", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most adverts to write. This must be a positive number: 0 is not read as \"everything\", because the whole board is about 111,000 adverts and a run that walked all of it by accident would bill for all of it.", "default": 100 } } }, "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 } } } } } } } } } }