{ "openapi": "3.0.1", "info": { "title": "Dice Employers, Grouped on the Id and Not the Name", "description": "Who is advertising on dice.com, with advert counts, locations and pay worked out from employer set figures only. Dice's own salary bands are counted separately rather than averaged in, because they are not what anyone pays.", "version": "0.1", "x-build-id": "txiKuorymn13Tdoqg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gubidonius~dice-employers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gubidonius-dice-employers", "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-employers/runs": { "post": { "operationId": "runs-sync-gubidonius-dice-employers", "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-employers/run-sync": { "post": { "operationId": "run-sync-gubidonius-dice-employers", "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": [ "maxAdvertsToRead" ], "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 returns the whole United States board rather than an error, so this run checks for that and stops. Leave empty for the whole board.", "default": "" }, "postedDate": { "title": "Posted within", "enum": [ "", "ONE", "THREE", "SEVEN" ], "type": "string", "description": "dice.com offers these three windows and nothing else.", "default": "" }, "employmentType": { "title": "Contract type", "enum": [ "", "FULLTIME", "PARTTIME", "CONTRACTS", "THIRD_PARTY" ], "type": "string", "description": "dice.com takes the value, not the label. A label returns zero adverts rather than an error.", "default": "" }, "employerType": { "title": "Who is advertising", "enum": [ "", "Direct Hire", "Recruiter", "Other" ], "type": "string", "description": "Use Recruiter to list the agencies, or Direct Hire to list the employers themselves.", "default": "" }, "workplaceTypes": { "title": "Workplace", "enum": [ "", "On-Site", "Remote", "Hybrid" ], "type": "string", "description": "The remote filter that works.", "default": "" }, "willingToSponsor": { "title": "Visa sponsorship offered", "enum": [ "", "true", "false" ], "type": "string", "description": "Employers who said they will sponsor a visa. 1,163 adverts of 111,682 on 2026-09-16.", "default": "" }, "minAdverts": { "title": "Least adverts to include an employer", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Drop employers with fewer adverts than this in what was read. 1 keeps every employer.", "default": 1 }, "maxAdvertsToRead": { "title": "How many adverts to read", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The employers are worked out from the adverts the board serves, so this is the size of the sample, not the number of employers. Must be a positive number: 0 is not read as \"everything\". The board stops serving new adverts at roughly 740 whatever you ask for, which the run summary reports.", "default": 500 } } }, "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 } } } } } } } } } }