{ "openapi": "3.0.1", "info": { "title": "Wellfound Jobs Scraper — Startup Roles, Pay & Companies", "description": "Search startup jobs by role and location and get one row per posting: the full description, the pay Wellfound shows, the experience asked for, the remote policy, and the hiring company with its size, website tags and hiring badges. Several roles and cities in one run.", "version": "0.1", "x-build-id": "y0MCOjTjrCrT7vKcX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thenetaji~wellfound-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thenetaji-wellfound-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/thenetaji~wellfound-jobs-scraper/runs": { "post": { "operationId": "runs-sync-thenetaji-wellfound-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/thenetaji~wellfound-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-thenetaji-wellfound-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": { "roles": { "title": "Roles", "type": "array", "description": "Role slugs to search, one per line, exactly as they appear in a wellfound.com/role/ URL: `software-engineer`, `designer`, `data-scientist`, `product-manager`. A full role URL may be pasted instead and the slug is taken from it.\n\nRoles come from Wellfound's own vocabulary; a slug it publishes no page for cannot be searched, and there is no way to list the vocabulary from here. A role that returns nothing is reported in the run log and the remaining searches continue.\n\nAt least one role or one location is required. Given both, every role is searched in every location — three roles and two locations is six searches.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Location slugs to search, one per line, exactly as they appear in a wellfound.com/location/ URL: `san-francisco`, `new-york`, `london`, `remote-us`. A full location URL may be pasted instead.\n\nUsed alone it searches every role in that location; combined with roles it searches each pair. At least one role or one location is required.", "items": { "type": "string" } }, "remote": { "title": "Remote only", "type": "boolean", "description": "Restrict the search to remote postings.\n\nAvailable on a role-only search and nowhere else. Wellfound publishes a remote variant of its role pages and none of its location pages, so a run that sets this together with a location is refused rather than answered with results that quietly ignore it. Search the `remote-us` location slug instead when a location is what matters.", "default": false }, "maxItems": { "title": "Max jobs per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many job rows to save from each search. Three roles at 100 is up to 300 rows.\n\nThe upper bound is 500 and it is Wellfound's, not a preference: a result set is walked until it starts repeating itself, which on a narrow query happens well before 500. Another role or another location reaches further than a larger number here does.", "default": 40 }, "enrichJobDetails": { "title": "Add posting details", "type": "boolean", "description": "Read each job's own posting page and add the structured pay range with the period it is quoted over, the employment type, whether the application is completed on Wellfound or handed to the company's system, the company's own website, the industries it lists, its stated benefits and the posting body as published HTML.\n\nOne extra request per job, billed per job enriched and only when the posting page returns something. Leave it off when the search row's own pay string and description are enough.", "default": false } } }, "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 } } } } } } } } } }