{ "openapi": "3.0.1", "info": { "title": "Wellfound Jobs Scraper — Startup Roles, Salary & Equity", "description": "Startup jobs from Wellfound's public role listings, by role and city or remote: title, salary and equity as shown, location, remote policy, experience, posting date, ATS, and each startup's size, stage, badges and pitch. No browser, no key, no recruiter contacts.", "version": "0.1", "x-build-id": "vNIIzgxn0splmSWUV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insight.solutions~wellfound-jobs-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insight.solutions-wellfound-jobs-api", "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/insight.solutions~wellfound-jobs-api/runs": { "post": { "operationId": "runs-sync-insight.solutions-wellfound-jobs-api", "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/insight.solutions~wellfound-jobs-api/run-sync": { "post": { "operationId": "run-sync-insight.solutions-wellfound-jobs-api", "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", "required": [ "roles" ], "properties": { "roles": { "title": "Roles", "maxItems": 100, "type": "array", "description": "One per line. A Wellfound role slug as it appears in its URLs (`software-engineer`, `product-manager`, `data-scientist`, `frontend-engineer`, `account-executive`…) or a common title (`Software Engineer`, `ML engineer`, `PM`), which is matched to the nearest slug. A title that matches no role is reported in a free `unresolved` row and costs no request. Each role is searched in each location.", "items": { "type": "string" } }, "locations": { "title": "Locations", "maxItems": 100, "type": "array", "description": "One per line. `remote` reads Wellfound's remote listing for each role; a city slug (`new-york`, `san-francisco`, `austin`, `los-angeles`, `seattle`, `boston`, `chicago`, `denver`, `district-of-columbia`…) or a city as you would write it (`Austin, TX`, `NYC`, `Washington, DC`) reads that city's listing. Empty: `remote` only. At most 100 searches (roles × locations) per run.", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "string", "description": "Optional. Keep a job only when every word appears in its title or description (case-insensitive). Applied to the listings this Actor reads, not sent to Wellfound. Empty: every job.", "default": "" }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only jobs Wellfound marks remote. Every job on a `remote` listing is; on a city listing, some are.", "default": false }, "minSalary": { "title": "Minimum salary", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Optional. Keep a job only when the top of its displayed salary range reaches this number (in the listing's own currency, usually USD a year). Jobs that show no salary are dropped when this is set. 0: no salary filter.", "default": 0 }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Optional. Keep only jobs that went live on Wellfound within this many days. Wellfound's listings are not ordered by date (a page mixes jobs from this week with jobs years old), so with this set a search reads up to three times as many pages to fill `maxJobsPerSearch`. 0: no date filter.", "default": 0 }, "maxJobsPerSearch": { "title": "Maximum jobs per search", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Jobs returned per role × location, at most. Wellfound shows 20 startups a page with their 1–3 highlighted jobs (30–40 jobs a page), so 80 is two or three pages. Each search also stops at Wellfound's last page.", "default": 200 }, "includeDetails": { "title": "Read each job's own page", "type": "boolean", "description": "Also read each returned job's page (`/jobs/-`) for its JSON-LD posting: the company website, industry, employment type, structured locations, benefits and pay period. One extra request per job, so runs take longer; the listing already carries the full description, salary and equity. Off: listing pages only.", "default": false }, "maxConcurrency": { "title": "Searches in parallel", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many searches are read at once. Every request to wellfound.com starts at least half a second after the one before, whatever this is set to.", "default": 4 }, "maxRunSecs": { "title": "Maximum run time (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Wall-clock budget for the whole run. When it is reached the Actor stops reading, keeps — and bills — every row it already wrote, and files a free `timeout` row for each search it never started.", "default": 240 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Requests go out through this proxy; Apify's datacenter proxy by default, which is what the listing pages were tested through. If Wellfound answers with its security check, the run stops after that one request with a free `blocked` row; it is never retried through another exit.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }