{ "openapi": "3.0.1", "info": { "title": "BuiltIn Jobs Scraper API", "description": "Lowest price on the market for Built In jobs: $0.81 per 1,000, under every established Built In scraper (the rest start at $0.95). Search any board or a whole company for title, company, all locations, workplace type, salary, seniority, skills and the exact posted date. No login.", "version": "0.1", "x-build-id": "APRkZTqzmg7EK2kGH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~builtin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~builtin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~builtin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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 terms", "type": "array", "description": "Job titles or keywords to search on Built In, one per line. Example: \"data engineer\", \"product manager\". Leave empty if you only want the filters below, or only the URLs.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City or region, in plain text: \"Austin, TX\", \"New York\", \"Chicago\". Resolved through Built In's own location lookup. Leave empty to search every Built In location." }, "searchRadius": { "title": "Search radius", "enum": [ "", "5mi", "10mi", "25mi", "50mi", "100mi" ], "type": "string", "description": "How far around the location to look. Ignored when no location is set.", "default": "" }, "remotePreference": { "title": "Remote / hybrid / on-site", "enum": [ "", "remote", "hybrid", "office" ], "type": "string", "description": "Restrict to one working style. \"Any\" returns all of them and still tells you which each job is.", "default": "" }, "category": { "title": "Job category", "enum": [ "", "ai-machine-learning", "consultant", "content", "customer-success-experience", "cyber-security", "data-analytics", "designer", "engineering", "finance", "hr-recruiting", "internships", "legal", "marketing", "operations", "product", "project-mgmt", "sales" ], "type": "string", "description": "Built In's own job category.", "default": "" }, "experienceLevel": { "title": "Experience level", "enum": [ "", "internship", "entry-level", "junior", "mid-level", "senior", "expert-leader" ], "type": "string", "description": "Seniority band as Built In labels it.", "default": "" }, "postedWithinDays": { "title": "Posted within", "enum": [ "", "1", "3", "7", "30" ], "type": "string", "description": "Only jobs published in the last N days.", "default": "" }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on rows returned across every search and URL (1-10000). You are charged per job returned.", "default": 50 }, "startUrls": { "title": "Built In URLs", "type": "array", "description": "Optional. Paste single job pages (https://builtin.com/job/lead-data-engineer/10586279), board pages (https://builtin.com/jobs/remote/engineering), a company's board (https://builtin.com/company/crowdstrike/jobs) or a city site (https://builtinnyc.com/jobs). Works alongside the fields above.", "items": { "type": "string" } }, "includeJobDescription": { "title": "Include the full job description", "type": "boolean", "description": "Off by default. When on, the actor opens each job's own page to add the full description text and HTML, employment type, benefits and the closing date. This makes the run slower because it is one extra request per job. The price per job does not change.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The actor already uses its own egress; leave this alone unless you need to exit from a specific network." } } }, "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 } } } } } } } } } }