{ "openapi": "3.0.1", "info": { "title": "Wellfound (AngelList) Jobs Scraper – Salary & Equity", "description": "Scrape startup jobs from Wellfound (formerly AngelList Talent) by role, location or remote: title, salary range, equity, full description, experience, workplace policy, plus company stage, size and badges (YC, top investors, recently funded).", "version": "1.0", "x-build-id": "oYbD948ZBRQwU1tNP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kirozhang~wellfound-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kirozhang-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/kirozhang~wellfound-jobs-scraper/runs": { "post": { "operationId": "runs-sync-kirozhang-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/kirozhang~wellfound-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-kirozhang-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": "Wellfound role names, e.g. \"software-engineer\", \"product-manager\", \"data-scientist\", \"designer\", \"sales\", \"marketing\", \"devops-engineer\", \"machine-learning-engineer\". Spaces are fine (\"Software Engineer\").", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Optional cities or countries as used on Wellfound, e.g. \"san-francisco\", \"new-york\", \"london\", \"berlin\", \"bangalore\", \"united-states\", \"india\". Combined with every role. Leave empty for all locations.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only return remote jobs. Without roles and locations this scrapes all remote startup jobs.", "default": false }, "jobTypes": { "title": "Job types", "type": "array", "description": "Optional filter. Leave empty for all.", "items": { "type": "string", "enum": [ "full-time", "contract", "internship", "cofounder" ], "enumTitles": [ "Full-time", "Contract", "Internship", "Cofounder" ] }, "default": [] }, "postedWithinDays": { "title": "Posted within", "enum": [ "0", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only jobs posted within this many days.", "default": "0" }, "requireSalary": { "title": "Only jobs with salary", "type": "boolean", "description": "Skip jobs that do not publish a salary range.", "default": false }, "maxJobsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs saved for each role / location combination (and each start URL).", "default": 200 }, "startUrls": { "title": "Wellfound URLs (optional)", "type": "array", "description": "Paste Wellfound job pages such as https://wellfound.com/role/r/software-engineer, https://wellfound.com/role/l/product-manager/new-york, https://wellfound.com/location/london or https://wellfound.com/remote. All pages are followed automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Usually not needed: the Actor connects directly and switches to residential proxy automatically if Wellfound starts blocking. Set a proxy here only if you want to force one.", "default": { "useApifyProxy": false } }, "onlyNew": { "title": "Only new jobs (monitoring mode)", "type": "boolean", "description": "Off by default. When on, the first run saves a baseline and every later run with the same Tracking name returns – and charges – only jobs that were not returned before, plus new jobs per company in OUTPUT. Wellfound lists jobs by relevance, so set Max jobs per search high enough to cover the whole search. (Wellfound shows only some of each startup's jobs, so closed postings are not detected here.)", "default": false }, "trackingId": { "title": "Tracking name", "type": "string", "description": "Used with Only new jobs: a stable name for this search (e.g. 'data-jobs-sydney'). Runs with the same name share history." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Optional. A Slack Incoming Webhook URL (https://hooks.slack.com/services/…). After a run you get one summary message in that channel. Stored encrypted." }, "webhookUrl": { "title": "Webhook URL (JSON)", "type": "string", "description": "Optional. Any https endpoint (Make, Zapier, n8n, a Microsoft Teams workflow or your own server). Receives one JSON POST per run with counts, items and the report link. Stored encrypted." }, "notifyOn": { "title": "Send a notification when", "enum": [ "alerts", "always" ], "type": "string", "description": "When the Slack / webhook message is sent.", "default": "alerts" }, "publicReport": { "title": "Shareable report link", "type": "boolean", "description": "Off by default; needs Only new jobs. When on, an HTML report with new jobs, hiring by company and 7/30-day trends is kept at one fixed link per Tracking name (OUTPUT.reportUrl) that updates after every run. Anyone with the link can open it.", "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 }, "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 } } } } } } } } } }