{ "openapi": "3.0.1", "info": { "title": "Built In Jobs Scraper", "description": "Scrape open tech and startup roles from Built In (builtin.com): title, employer, location, workplace type (remote/hybrid/on-site), salary (where posted), experience level and apply URL. Give it a keyword query. No login, no account.", "version": "1.0", "x-build-id": "Uy4pjgUHxpoCxagS0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zilicon~builtin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zilicon-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/zilicon~builtin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-zilicon-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/zilicon~builtin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-zilicon-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": { "keywords": { "title": "Search keywords", "type": "string", "description": "What to search Built In for, e.g. 'software engineer', 'data engineer', 'product manager'. This is sent to Built In's own search (?search=), so it returns the same roles the site would. Leave blank to return the newest roles across all of Built In." }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many roles. Your cost control. Built In returns ~25 roles per page, so 100 walks about 4 pages. Set 0 for no cap (walks until the last result page).", "default": 100 }, "titleOnly": { "title": "Match title only", "type": "boolean", "description": "Keep only roles whose TITLE contains all of your keywords. Built In ranks by relevance and may return loosely related roles; turn this on to keep only titles that actually name your terms.", "default": false }, "excludeKeywords": { "title": "Exclude keywords", "type": "string", "description": "Drop any role containing ANY of these words, e.g. 'senior manager clearance'. Applied to the title, company, workplace type, location and experience level. Useful for stripping seniority or terms you do not want." }, "location": { "title": "Location filter", "type": "string", "description": "Keep only roles whose location contains ALL of these words, e.g. 'new york' or 'chicago'. Built In serves the location on the search card itself, so no extra fetch is needed. Note: a role posted in multiple cities shows as 'N Locations' on the card and will not match a city name." }, "remoteOnly": { "title": "Remote roles only", "type": "boolean", "description": "Keep only remote roles. Uses the workplace-type label on the search card (Remote / Remote or Hybrid) plus the location text.", "default": false }, "maxPages": { "title": "Max pages", "minimum": 1, "type": "integer", "description": "Hard cap on how many search pages to walk, as a safety limit for a very broad query. Built In returns ~25 roles per page. Leave the default unless you know you need more.", "default": 200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy configuration. Datacenter proxies are fine for Built In.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }