{ "openapi": "3.0.1", "info": { "title": "Wellfound Jobs Scraper", "description": "Build startup-job shortlists from Wellfound by role, location and remote filter. Export job descriptions, disclosed salary and equity, company details and apply links for recruiting research or job feeds. No Wellfound login required.", "version": "0.1", "x-build-id": "KI9UfeVq7us8iZr5b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/keystonelabs~wellfound-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-keystonelabs-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/keystonelabs~wellfound-jobs-scraper/runs": { "post": { "operationId": "runs-sync-keystonelabs-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/keystonelabs~wellfound-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-keystonelabs-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": "Job roles", "type": "array", "description": "Roles to search, one per line, as they appear in Wellfound URLs: software-engineer, product-manager, data-scientist, devops-engineer, sales-engineer, backend-engineer and 500+ more. Plain names such as 'Software Engineer' are converted automatically. Each role becomes one search feed.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Optional location filter, one per line, as Wellfound location slugs: new-york, san-francisco, austin, boston, denver, seattle, chicago, los-angeles, district-of-columbia, united-states, india, london. Combined with Job roles, every role x location pair is searched. Leave empty to search all locations.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Return only jobs that are open to remote work.", "default": false }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional. Keep only jobs whose title, company name or description contains at least one of these terms (case-insensitive), for example React, Kubernetes, fintech.", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Optional. Skip jobs posted more than this many days ago. 0 disables the filter.", "default": 0 }, "startUrls": { "title": "Wellfound listing URLs", "type": "array", "description": "Optional. Paste Wellfound search pages directly, for example https://wellfound.com/role/r/backend-engineer, https://wellfound.com/role/l/software-engineer/new-york or https://wellfound.com/location/austin. Company pages are not supported.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many unique jobs have been saved across all feeds. Each Wellfound feed exposes at most 47 pages (roughly 1,500 to 1,900 jobs), so combine several roles or locations to go wider.", "default": 100 }, "maxPagesPerFeed": { "title": "Max pages per feed", "minimum": 1, "maximum": 47, "type": "integer", "description": "How deep to page into each role or location feed. Wellfound serves at most 47 pages per feed; each page holds 30 to 60 jobs.", "default": 47 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many feeds to scrape in parallel. Keep it low; one request already yields about 40 jobs.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Route requests through Apify Proxy if Wellfound starts answering with a security check from your IP range.", "default": { "useApifyProxy": 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 } } } } } } } } } }