{ "openapi": "3.0.1", "info": { "title": "Wellfound Jobs Scraper (AngelList) — Salary & Equity Data", "description": "Scrape Wellfound (AngelList) startup jobs with salary and equity as sortable numbers, plus company size, YC badge and the ATS each company uses.", "version": "1.0", "x-build-id": "8rv0d1JJewIncadhR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/spool~angellist-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-spool-angellist-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/spool~angellist-jobs-scraper/runs": { "post": { "operationId": "runs-sync-spool-angellist-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/spool~angellist-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-spool-angellist-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", "required": [ "roles" ], "properties": { "roles": { "title": "1. What jobs?", "minItems": 1, "type": "array", "description": "Pick from the list, or type any role Wellfound uses (e.g. `backend-engineer`). Each role is searched separately.", "items": { "type": "string", "enumSuggestedValues": [ "software-engineer", "frontend-engineer", "backend-engineer", "data-scientist", "data-analyst", "product-manager", "product-designer", "designer", "ui-ux-designer", "graphic-designer", "marketing", "growth-marketer", "sales", "sales-manager", "account-manager", "operations-manager", "financial-analyst", "hr-manager" ], "enumTitles": [ "Software Engineer", "Frontend Engineer", "Backend Engineer", "Data Scientist", "Data Analyst", "Product Manager", "Product Designer", "Designer", "UI/UX Designer", "Graphic Designer", "Marketing", "Growth Marketer", "Sales", "Sales Manager", "Account Manager", "Operations Manager", "Financial Analyst", "HR Manager" ] }, "default": [ "software-engineer" ] }, "locations": { "title": "2. Where? (optional)", "type": "array", "description": "Leave empty for REMOTE jobs. Pick cities for on-site roles, or type any city slug. Every role is paired with every location — 2 roles × 3 cities = 6 searches. Note that \"Remote\" and an empty list are the same search.", "items": { "type": "string", "enumSuggestedValues": [ "remote", "san-francisco", "new-york", "los-angeles", "austin", "seattle", "boston", "chicago", "denver", "miami", "atlanta", "toronto", "vancouver", "london", "berlin", "paris", "amsterdam", "dublin", "lisbon", "barcelona", "madrid", "tel-aviv", "bangalore", "singapore", "sydney" ], "enumTitles": [ "Remote", "San Francisco", "New York", "Los Angeles", "Austin", "Seattle", "Boston", "Chicago", "Denver", "Miami", "Atlanta", "Toronto", "Vancouver", "London", "Berlin", "Paris", "Amsterdam", "Dublin", "Lisbon", "Barcelona", "Madrid", "Tel Aviv", "Bangalore", "Singapore", "Sydney" ] } }, "maxItems": { "title": "3. How many jobs?", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stops as soon as this many unique jobs are saved. Duplicates never count toward it, so you always get what you asked for.", "default": 200 }, "onlyWithSalary": { "title": "Only jobs that show a salary", "type": "boolean", "description": "About 92% of Wellfound listings publish pay. Turn this on for salary benchmarking so blank rows don't skew your averages.", "default": false }, "onlyRemote": { "title": "Only remote jobs", "type": "boolean", "description": "Keep only listings marked remote by the company.", "default": false }, "onlyWithEquity": { "title": "Only jobs offering equity", "type": "boolean", "description": "Keep only listings that state an equity range. Equity is common at early-stage startups and rarer at large ones.", "default": false }, "salaryMinimum": { "title": "Pays at least", "minimum": 0, "type": "integer", "description": "Listings that publish no salary are excluded when you set this." }, "salaryMaximum": { "title": "Pays at most", "minimum": 0, "type": "integer", "description": "Keep only jobs whose published minimum salary is at or below this. Useful for finding roles in a specific band." }, "keywords": { "title": "Job title contains any of", "type": "array", "description": "Case-insensitive. e.g. `senior`, `staff`, `machine learning`.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Job title does NOT contain", "type": "array", "description": "e.g. `intern`, `contract`, `senior`.", "items": { "type": "string" } }, "requiredBadges": { "title": "Company signals", "type": "array", "description": "Company must have every signal you pick. Great for sourcing — `Y Combinator` finds YC companies, `Top investors` finds well-funded ones.", "items": { "type": "string", "enumSuggestedValues": [ "YC", "TOP_INVESTORS", "GROWING_FAST", "ACTIVELY_HIRING", "HIGHLY_RATED", "QUICK_RESPONDER", "TOP_RESPONDER", "STRONG_LEADERSHIP", "WORK_LIFE_BALANCE", "VALUATION_1B", "VALUATION_500M", "B2B", "B2C" ], "enumTitles": [ "Y Combinator", "Top investors", "Growing fast", "Actively hiring", "Highly rated", "Quick responder", "Top responder", "Strong leadership", "Work-life balance", "$1B+ valuation", "$500M+ valuation", "B2B", "B2C" ] } }, "companySizes": { "title": "Company size", "type": "array", "description": "Keep only companies in these headcount bands. Pick several to widen the range.", "items": { "type": "string", "enumSuggestedValues": [ "SIZE_1_10", "SIZE_11_50", "SIZE_51_200", "SIZE_201_500", "SIZE_501_1000", "SIZE_1001_5000", "SIZE_5000_PLUS" ], "enumTitles": [ "1-10 (seed)", "11-50 (early)", "51-200 (growth)", "201-500 (mid)", "501-1000 (late)", "1001-5000 (large)", "5000+ (enterprise)" ] } }, "jobTypes": { "title": "Employment type", "type": "array", "description": "Most Wellfound listings are full-time.", "items": { "type": "string", "enumSuggestedValues": [ "full-time", "part-time", "contract", "internship", "cofounder" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Internship", "Cofounder" ] } }, "atsProviders": { "title": "Applicant tracking system", "type": "array", "description": "Which system the company posts through. Useful if you sell recruiting tools.", "items": { "type": "string", "enumSuggestedValues": [ "Greenhouse", "Lever", "Ashby", "Workable", "SmartRecruiters" ], "enumTitles": [ "Greenhouse", "Lever", "Ashby", "Workable", "SmartRecruiters" ] } }, "maxYearsExperience": { "title": "Asks for at most", "minimum": 0, "maximum": 30, "type": "integer", "description": "Listings that state no requirement are kept." }, "datePosted": { "title": "Date posted", "type": "string", "description": "How recent the listing must be. Wellfound keeps listings live a long time — the median is around 50 days old — so short windows return few results. You can also type a custom number of days.", "default": "" }, "includeDescription": { "title": "Include full job descriptions", "type": "boolean", "description": "Descriptions run to several thousand characters. Turn off for a much lighter dataset when you only need titles, companies and pay.", "default": true }, "maxPagesPerSearch": { "title": "Pages per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "Each page adds roughly 30 more jobs. 1 page ≈ 45 jobs, 10 pages ≈ 300, and a busy role has ~48 pages (~1,900 jobs). Raise this to go deeper; the scraper stops early on its own when a search runs out.", "default": 10 }, "startUrls": { "title": "Direct Wellfound URLs", "type": "array", "description": "Paste Wellfound search URLs to scrape them as-is, in addition to anything above.", "items": { "type": "string" } }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Searches run in parallel. Lower this if you see blocking errors.", "default": 3 }, "maxRetries": { "title": "Max retries per page", "minimum": 1, "maximum": 8, "type": "integer", "description": "Blocked retries switch to residential proxy automatically.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Wellfound blocks plain datacenter IPs, so Apify Proxy is on by default.", "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 } } }, "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 } } } } } } } } } }