{ "openapi": "3.0.1", "info": { "title": "Wellfound Jobs Scraper - Salary, Equity & Remote", "description": "Scrape Wellfound startup jobs with salary, equity, remote status, skills, company data, and apply URLs. MCP optimized, no login required. Charged $0.008 per returned job.", "version": "1.1", "x-build-id": "dtiSoU1azdUUxHXyO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~wellfound-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~wellfound-jobs-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~wellfound-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": { "role": { "title": "Role", "type": "string", "description": "Use this when you want Wellfound startup jobs for a specific role. Enter a plain job title such as 'software engineer' or 'product manager'. Defaults to 'software engineer'. This is not a Wellfound URL; paste URLs into Start URLs instead.", "default": "software engineer" }, "location": { "title": "Location", "type": "string", "description": "Use this when you want jobs in a city, country, or startup hub. Enter Wellfound-style text such as 'san francisco', 'new york', or 'united states'. Defaults to blank when Remote only is enabled. This is not a country code field.", "default": "" }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Use this when you only want remote Wellfound jobs for the selected role. When true, the actor uses Wellfound remote role pages such as /role/r/software-engineer. Defaults to true for a reliable small health-check run. This does not guarantee every company hires in every country.", "default": true }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Use this when you already have Wellfound role, location, remote, or job-detail URLs. Accepts URLs like https://wellfound.com/role/l/software-engineer/san-francisco or https://wellfound.com/jobs/1234567. When set, Role, Location, and Remote only are ignored. This is not for LinkedIn, Indeed, or Google Jobs URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Use this to cap the number of Wellfound jobs returned and billed in one run. Accepts 1 to 50000; the default is 100. The actor stops before charging past this limit. This is not a page count.", "default": 100 }, "enrichDetails": { "title": "Fetch job detail pages", "type": "boolean", "description": "Use this when you want richer job fields from individual Wellfound job pages. Defaults to true and falls back to listing data if a detail page is blocked. Disable it for faster lightweight search exports. This does not scrape private applicant or recruiter data.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use this to control how the actor reaches Wellfound. Defaults to Apify Residential proxies in the United States because Wellfound search pages use DataDome and Cloudflare protection. Leave unchanged for most runs. This is not an authentication or cookie setting.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Use this to tune how many Wellfound pages are open in parallel. Accepts 1 to 10; the default is 3 for safer session consistency. Lower it if the run hits blocks, raise it only for healthy large exports. This is not the result limit.", "default": 3 }, "debugDumpHtml": { "title": "Debug dump HTML", "type": "boolean", "description": "Use this only for troubleshooting extractor drift. When enabled, raw HTML snapshots are saved to the key-value store under DEBUG keys. Defaults to false. This is not needed for normal exports.", "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 } } } } } } } } } }