{ "openapi": "3.0.1", "info": { "title": "Built In Jobs, Past the 400-Page Ceiling", "description": "Job adverts from builtin.com with pay, level, workplace type, every location and the board's skill tags. The board serves no page after the 400th and never says how big a search is. This one reads the size from the paginator and cuts a big search into cells.", "version": "0.1", "x-build-id": "Hn7YOSyAf4AsIKVGB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gubidonius~builtin-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gubidonius-builtin-jobs", "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/gubidonius~builtin-jobs/runs": { "post": { "operationId": "runs-sync-gubidonius-builtin-jobs", "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/gubidonius~builtin-jobs/run-sync": { "post": { "operationId": "run-sync-gubidonius-builtin-jobs", "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": { "search": { "title": "Search", "type": "string", "description": "Job title, company or keyword, as you would type it into the board. Leave it empty to walk the whole board under the filters below.", "default": "" }, "categories": { "title": "Job category", "type": "array", "description": "One of the board's 16 categories, by name or URL alias: Engineering, Data & Analytics, AI & Machine Learning, Product Management, Sales, Marketing and so on. The board filters on ONE category at a time, so only the first is applied and the rest are named in RUN_SUMMARY. A name the board does not have is reported with the nearest real names rather than guessed.", "default": [], "items": { "type": "string" } }, "subcategories": { "title": "Subcategory", "type": "array", "description": "Subcategories under the category above, for example Back End Developer, Data Engineer, Machine Learning Engineer. A subcategory only filters under its own category, so the category is added for you when you name a subcategory alone.", "default": [], "items": { "type": "string" } }, "workplaceTypes": { "title": "Workplace", "type": "array", "description": "Remote, Hybrid, In-Office. Several at once are allowed.", "default": [], "items": { "type": "string" } }, "experienceLevels": { "title": "Experience level", "type": "array", "description": "Internship, Entry level, Junior, Mid level, Senior, Expert/Leader, Not specified. Several at once are allowed.", "default": [], "items": { "type": "string" } }, "industries": { "title": "Industry", "type": "array", "description": "The employer's industry, from the board's list of 103, for example Fintech, Healthtech, Aerospace. A company carries several, so an industry cut is a cover rather than a partition and the run deduplicates on the advert id.", "default": [], "items": { "type": "string" } }, "companySizes": { "title": "Company size", "type": "array", "description": "1-10, 11-50, 51-200, 201-500, 501-1000, 1000+ employees.", "default": [], "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within days", "type": "integer", "description": "Only adverts posted or reposted in the last 1, 3, 7 or 30 days, which are the only windows the board has. 0 means no date filter.", "default": 0 }, "skills": { "title": "Skills", "type": "array", "description": "Skill tags as the board spells them, for example Python, AWS, Kubernetes. The board applies a skill filter only alongside a search term or a category.", "default": [], "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "A city as the board writes it, for example Austin. Pair it with state and country.", "default": "" }, "state": { "title": "State", "type": "string", "description": "The state written out, for example Texas.", "default": "" }, "country": { "title": "Country", "type": "string", "description": "Three-letter code, USA by default. The board is US-first and answers a national search when no city is given.", "default": "USA" }, "searchRadiusMiles": { "title": "Search radius in miles", "type": "integer", "description": "Around the city: 5, 10, 25, 50 or 100. 0 leaves the board's own default.", "default": 0 }, "allLocations": { "title": "All locations", "type": "boolean", "description": "Every country the board lists, not only the one above. Rows then carry places like Bengaluru, KA, IND beside Austin, TX, USA.", "default": false }, "companyId": { "title": "Company id", "type": "integer", "description": "Only this employer's adverts. The number is the companyId column of builtin-companies or builtin-company-details. 0 means every employer.", "default": 0 }, "earlyApplicantOnly": { "title": "Early applicant only", "type": "boolean", "description": "Only adverts the board marks Be an Early Applicant.", "default": false }, "maxResults": { "title": "Row budget", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Most adverts to return, and the most you will be charged for. Up to 10,000 the board is walked in its own order. Past 10,000 the search is cut into cells on category, experience, workplace, company size and industry, because the board serves no page after the 400th.", "default": 100 } } }, "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 } } } } } } } } } }