{ "openapi": "3.0.1", "info": { "title": "Built In Jobs Scraper | Salaries & Skills", "description": "Scrape Built In jobs by keyword, location, company jobs URL, or filtered search. Extract titles, employers, skills, workplace types, published salaries, and full descriptions. Export unique jobs to JSON, CSV, or Excel for recruiting and hiring research. No run-start charge.", "version": "0.1", "x-build-id": "G0ZyFpke6RtK4UwIu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datascraperes~builtin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datascraperes-builtin-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/datascraperes~builtin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-datascraperes-builtin-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/datascraperes~builtin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-datascraperes-builtin-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": { "searchQueries": { "title": "Search keywords", "maxItems": 50, "type": "array", "description": "Up to 50 keywords. Defaults to software engineer when both search inputs are empty.", "items": { "type": "string" } }, "startUrls": { "title": "Built In URLs", "maxItems": 50, "type": "array", "description": "Search pages, company jobs pages or individual jobs. URL filters are preserved; keyword filters do not override them.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Complete location label, for example Austin, TX, USA. Blank searches all locations. Ambiguous locations fail clearly.", "default": "" }, "remoteMode": { "title": "Workplace filter", "enum": [ "any", "remote", "hybrid", "office" ], "type": "string", "description": "Uses Built In filtering, which can include mixed workplace arrangements.", "default": "any" }, "category": { "title": "Job category", "enum": [ "", "ai-machine-learning", "consultant", "customer-success-experience", "cyber-security", "data-analytics", "designer", "engineering", "finance", "hr-recruiting", "legal", "marketing", "operations-support", "product-management", "program-project-management", "sales", "supply-chain-procurement" ], "type": "string", "description": "Functional category for keyword searches.", "default": "" }, "experienceLevel": { "title": "Experience level", "enum": [ "", "internship", "entry-level", "junior", "mid-level", "senior", "expert-leader", "not-specified" ], "type": "string", "description": "Seniority filter for keyword searches.", "default": "" }, "postedWithinDays": { "title": "Updated within", "enum": [ "", "1", "3", "7", "30" ], "type": "string", "description": "Built In update recency filter, not a guarantee of original posting date.", "default": "" }, "maxResultsPerQuery": { "title": "Maximum results per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Exact cap on new unique jobs delivered by each keyword or URL.", "default": 100 }, "fetchDescription": { "title": "Enrich job details", "type": "boolean", "description": "Fetch description, structured salary, locations and requirements. Individual job URLs always load their detail.", "default": true }, "maxPagesPerQuery": { "title": "Maximum pages per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Safety limit. Reaching it with more pages remaining is reported as incomplete.", "default": 400 } } }, "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 } } } } } } } } } }