{ "openapi": "3.0.1", "info": { "title": "Built In Jobs Scraper", "description": "Scrape tech and startup jobs from Built In (builtin.com) in bulk: title, company, location, remote type, salary range, seniority, skills and apply URL - one clean row per job. Search by keyword and location; deep pagination with automatic de-duplication.", "version": "0.1", "x-build-id": "8vXIEn95rVWJxCkJv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeworks~builtin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeworks-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/scrapeworks~builtin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-scrapeworks-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/scrapeworks~builtin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeworks-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": { "searchTerms": { "title": "Search terms (keyword / job title / skill)", "uniqueItems": true, "type": "array", "description": "One or more keywords to search Built In jobs for - a job title like 'software engineer', a skill like 'python' or 'react', or a company name. Every search term is run against every location below (so 4 terms x 3 locations = 12 searches), and each search is paginated deep. Results are billed per job row, so more terms = more rows. Leave empty to scrape the whole jobs feed (optionally narrowed by Locations / Remote only).", "items": { "type": "string" } }, "locations": { "title": "Locations", "uniqueItems": true, "type": "array", "description": "Locations to filter by - 'City, ST' (e.g. 'Austin, TX', 'New York, NY') or just a city. Each search term is searched in each location (a cross product). Leave empty to search every term nationwide. Use 'Remote only' below for remote roles instead of a city.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "If enabled, only remote-eligible jobs are returned (Built In's Remote jobs board). Combine with Search terms to get, e.g., remote Python jobs. Leave off to include in-office and hybrid roles too.", "default": false }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Optional: only return jobs first posted or updated within this many days (e.g. 1, 7, 14, 30). Leave empty for all open jobs regardless of age." }, "searchUrls": { "title": "Built In job URLs (optional, power users)", "uniqueItems": true, "type": "array", "description": "Optional: paste full builtin.com/jobs URLs (e.g. 'https://builtin.com/jobs?search=devops&city=Chicago&state=IL', a category page like 'https://builtin.com/jobs/dev-engineering', or 'https://builtin.com/jobs/remote') with your own filters already applied in the browser. Each URL is scraped and paginated deep. Use this to apply any Built In filter (experience level, industry, company size, category) that the fields above don't cover.", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Maximum jobs to return for EACH term+location pair (and each pasted URL). The actor paginates automatically (about 25 jobs per page). Set high to pull a whole keyword or location deeply; duplicate jobs (same posting across searches) are removed automatically.", "default": 300 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to reach builtin.com. The default (Apify Residential proxy, US) is recommended - the site sits behind Cloudflare and can throttle datacenter traffic at volume. The actor automatically rotates to a fresh proxy session if a page is blocked.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }