{ "openapi": "3.0.1", "info": { "title": "Built In Jobs Scraper", "description": "Tech and startup jobs from Built In with the pay range as numbers, seniority, top skills, company industries and remote, hybrid or office workplace. Filter by keywords, Built In category, country, state or city, and add full descriptions when you need them.", "version": "0.1", "x-build-id": "azQXRwXwofw5v5j08" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~builtin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-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/deriverge~builtin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-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/deriverge~builtin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-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": "Keywords", "type": "string", "description": "Words every job must contain in its title, company, skills or industries, for example \"data engineer\", \"react\" or \"sales\". Built In does not let robots use its own keyword search, so the actor reads the listings and keeps the matching jobs; pick a Category as well to make this fast. Leave empty for all jobs." }, "category": { "title": "Category", "enum": [ "any", "content", "data-analytics", "data-analytics/analysis-reporting", "data-analytics/analytics", "data-analytics/business-intelligence", "data-analytics/data-engineering", "data-analytics/data-science", "data-analytics/machine-learning", "design-ux", "dev-engineering", "dev-engineering/android", "dev-engineering/c-sharp", "dev-engineering/cpp", "dev-engineering/devops", "dev-engineering/front-end", "dev-engineering/golang", "dev-engineering/hardware", "dev-engineering/ios", "dev-engineering/java", "dev-engineering/javascript", "dev-engineering/linux", "dev-engineering/management", "dev-engineering/net", "dev-engineering/perl", "dev-engineering/php", "dev-engineering/python", "dev-engineering/qa", "dev-engineering/ruby", "dev-engineering/salesforce", "dev-engineering/scala", "dev-engineering/security", "finance", "hr", "legal", "marketing", "operations", "operations/client-success", "operations/customer-support", "operations/it", "operations/office-management", "operations/operations-management", "operations/technical-support", "product", "project-management", "sales", "sales/account-executive", "sales/account-management", "sales/customer-success", "sales/leadership", "sales/sales-developement", "sales/sales-engineer", "sales/sales-operations", "entry-level", "internships", "senior", "country" ], "type": "string", "description": "Built In's own job category, for example Data: data engineering or Engineering: Python. The actor reads only the jobs in it, which makes a keyword search much faster.", "default": "any" }, "country": { "title": "Country", "enum": [ "USA", "CAN", "GBR", "IND", "DEU", "IRL", "NLD", "FRA", "ESP", "POL", "CZE", "AUS", "SGP", "BRA", "MEX", "ISR", "ANY" ], "type": "string", "description": "Country of the jobs. Built In otherwise picks a location from the server address, so a country is always sent.", "default": "USA" }, "state": { "title": "State or region (optional)", "type": "string", "description": "Full state or region name as Built In writes it, for example New York, California or England." }, "city": { "title": "City (optional)", "type": "string", "description": "City name, for example New York, Chicago, Austin or London. Use together with the state." }, "workplace": { "title": "Workplace", "enum": [ "any", "remote", "hybrid", "office" ], "type": "string", "description": "Keep only jobs with this workplace type. In office reads all jobs and keeps those labelled In-Office.", "default": "any" }, "searchUrls": { "title": "Search links from builtin.com (optional)", "type": "array", "description": "Built In job list addresses, for example https://builtin.com/jobs/remote/dev-engineering/python?country=USA. A search word in the link (search=) is matched on the jobs as Keywords. Each link is its own search.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title or company contains any of these.", "items": { "type": "string" } }, "includeDetails": { "title": "Include full job details", "type": "boolean", "description": "Opens each job for the full description (text and HTML), exact posting date, expiry date and employment type. Built In lets only about 150 job pages be opened in a row, so use it for smaller runs; the price is the same.", "default": false }, "newOnly": { "title": "Return only jobs new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only jobs that were not there before. Schedule it daily for a job alert.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"nyc-data\". Runs from a saved task get one automatically." }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "type": "integer", "description": "Hard cap on returned jobs. Built In shows 25 jobs per page (10 in a category) and the scraper reads up to 200 pages per search.", "default": 1000 } } }, "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 } } } } } } } } } }