# Wellfound Startup Job Scraper β€” Equity Ranges & Job Alerts (`blackfalcondata/wellfound-scraper`) Actor Scrape wellfound.com startup jobs with salary and equity ranges, location, remote status, experience level, and company name and size. Company-only lead-gen mode, incremental runs, and Slack/Telegram/Discord alerts on new postings. - **URL**: https://apify.com/blackfalcondata/wellfound-scraper.md - **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community) - **Categories:** Jobs, Lead generation, Automation - **Features:** Limited permissions - **Stats:** 2,683 total users, 491 monthly users, 99.8% runs succeeded, 7 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### What does Wellfound Startup Job Scraper do? Wellfound Startup Job Scraper extracts structured job data from [wellfound.com](https://wellfound.com) β€” including salary data, apply URLs, company metadata, full descriptions, remote-work indicators, location data, and skill tags. It supports keyword search, location filters, and controllable result limits, so you can run the same query consistently over time. **New to Apify?** [Sign up free](https://console.apify.com/sign-up?fpr=1h3gvi) and use the included $5 monthly platform credit to test this actor. ### Key features - **πŸš€ Startup equity & pay transparency:** capture the equity range and salary band each startup lists inline, and filter by minimum equity and salary β€” focus on offers that match your compensation targets, data mainstream job boards don't expose. - **♻️ Incremental mode:** recurring runs emit and charge only for listings that are new or whose tracked content changed. First run builds the baseline; subsequent runs emit only NEW / UPDATED / REAPPEARED records (UNCHANGED + EXPIRED opt-in). Saves 80–95% on daily monitoring. - **πŸ”” Notifications:** Telegram, Slack, Discord, WhatsApp Cloud API, and generic webhook out of the box. Pair with incremental for daily new-listing alerts without pipeline glue. - **πŸ“§ Email + phone extraction:** best-effort regex extraction of contact emails and phone numbers from descriptions β€” emitted as `extractedEmails[]` and `extractedPhones[]` on every record. - **πŸ’° Structured salary:** salary parsed into structured `salaryMin` / `salaryMax` / `salaryCurrency` / period β€” no string parsing on your side. Includes `salaryHidden` flag when the source filtered against a bracket but the listing itself doesn't disclose. - **🎯 Batch searches:** pass `["term1", "term2"]` for query, location, or city to batch multiple searches in one run β€” shared dedup state, single dataset, one Actor-Start charge instead of N. - **πŸ“¦ Compact mode:** AI-agent and MCP-friendly payloads with core fields only. - **βœ‚οΈ Description truncation:** cap description length with `descriptionMaxLength` to control LLM prompt cost and dataset size β€” set 0 for full descriptions, or any char-limit to trim. - **πŸ“Œ Change classification:** each record carries a `changeType` of NEW / UPDATED / UNCHANGED / REAPPEARED / EXPIRED. Default emits NEW + UPDATED + REAPPEARED; opt into the others with `emitUnchanged` / `emitExpired`. - **πŸ“€ Export anywhere:** Download the dataset as JSON, CSV, or Excel from the Apify Console, or stream live via the Apify API and integrations (Make, Zapier, Google Sheets, n8n, …). - **πŸ”Œ MCP connectors:** export your results into Notion via Apify's MCP connectors β€” a clean run-summary page, no glue code. Opt-in via the App connector field; deterministic field-mapping, no AI. Built on Apify's connector framework, so more destinations open up as their catalog grows. ### What data can you extract from wellfound.com? Each result includes Core job fields (`id`, `title`, `slug`, `portalUrl`, `compensation`, `salaryMin`, `salaryMax`, and `salaryEquityMin`, and more), extended fields (`detailUrl`, `description`, `descriptionHtml`, `descriptionMarkdown`, and `primaryRoleTitle`), apply information (`directApply`), and company metadata (`companyId`, `companySlug`, `companyName`, and `companyLogo`). In standard mode, all fields are always present β€” unavailable data points are returned as `null`, never omitted. In compact mode, only core fields are returned. ### Input The main inputs are a search keyword, an optional location filter, and a result limit. Additional filters and options are available in the input schema. Key parameters: - **`query`** β€” Free-text job search (e.g. "rust engineer", "product designer"). A phrase Wellfound has a job category for searches that category; any other phrase keeps only jobs whose title contains its words. Combine with roles/searchUrls to union multiple searches. - **`roles`** β€” Wellfound's built-in role categories. Each spawns a separate search thread. Common slugs: software-engineer, product-manager, product-designer, data-analyst, growth-marketer, sales-manager, account-manager, hr-manager, operations-manager, financial-analyst, graphic-designer, ui-ux-designer. Free-text β€” you can also try other slugs. - **`searchUrls`** β€” Paste full Wellfound search URLs (e.g. https://wellfound.com/role/l/product-manager/berlin). Each URL spawns a separate search thread. Mix with query/roles freely β€” all deduplicate by job ID. - **`location`** β€” One or more location slugs (e.g. \["new-york", "san-francisco", "berlin"]). Each location Γ— role combination spawns a separate search thread. Ignored for pasted searchUrls (they carry their own location). - **`excludeLocations`** β€” Drop jobs whose locationNames match any of these (substring match, e.g. "India" drops "Bangalore, India"). Applied after fetch. - **`remote`** β€” When true, scrapes remote-filtered URLs. Ignored for pasted searchUrls. (default: `false`) - **`originLocation`** β€” City name for radius-based filtering (e.g. "San Francisco", "Bengaluru", "London"), or coordinates as "latitude, longitude" (e.g. "40.7128, -74.0060"). Used with radiusMiles or radiusKm. Covers ~110 startup hubs worldwide; a city outside that list skips the radius filter with a warning, so use coordinates for it. - **`radiusMiles`** β€” Keep only jobs within N miles of originLocation. Each job's own page supplies its coordinates and is fetched automatically when a radius is set, so radius runs take longer; a job whose page gives no coordinates is left out. US-standard unit. (default: `0`) - **`radiusKm`** β€” Kilometer alternative to radiusMiles. If both set, radiusMiles wins. Use this for EU-based searches. (default: `0`) - **`jobType`** β€” Filter by employment type. Matches Wellfound's jobType field (substring, case-insensitive). - **`experienceLevel`** β€” Filter by minimum required years of experience. Entry: 0-2, Mid: 2-5, Senior: 5-8, Staff+: 8+. Jobs without experience data are kept. - **`salaryMin`** β€” Drop jobs whose salary max is below this. 0 = no minimum. Jobs without salary data are dropped when minimum is set. (default: `0`) - ...and 44 more parameters ### Input examples **Basic search** β€” Keyword-driven search with a result cap. β†’ Full payload per result β€” all standard fields populated where the source provides them. ```json { "query": "software engineer", "maxResults": 50 } ``` **Filtered search** β€” Narrow results with advanced filters β€” only matching jobs are returned. β†’ Same field set as basic search; fewer, more relevant rows. ```json { "query": "software engineer", "jobType": "fulltime", "experienceLevel": "entry", "maxResults": 100 } ``` **Incremental tracking** β€” Only emit jobs that changed since the previous run with this `stateKey`. β†’ First run builds the baseline state. Subsequent runs emit only records that are new or whose tracked content changed. Set `emitUnchanged: true` to include unchanged records as well. ```json { "query": "software engineer", "maxResults": 200, "incrementalMode": true, "stateKey": "software-engineer-tracker" } ``` **Compact filtered output** β€” Combine filters with compact mode for a lightweight AI-agent or MCP data source. β†’ Core fields only β€” ideal for piping into LLMs or downstream tools without token overhead. ```json { "query": "software engineer", "jobType": "fulltime", "experienceLevel": "entry", "maxResults": 50, "compact": true } ``` ### Output Each run produces a dataset of structured job records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console. ### Example job record ```json { "id": "4716549", "title": "Senior Software Engineer", "slug": "senior-software-engineer", "portalUrl": "https://wellfound.com/jobs/4716549-senior-software-engineer", "detailUrl": "https://wellfound.com/jobs/4716549-senior-software-engineer", "compensation": "$175k – $225k β€’ 0.5% – 1.0%", "salaryMin": 175000, "salaryMax": 225000, "salaryEquityMin": "0.5%", "salaryEquityMax": "1.0%", "hasEquity": true, "description": "## Senior Software Engineer, Fintech Platform\n\n**Location:** USA\n\n**Experience:** 5+ years preferred\n\n### The role\n\nHourglass is building a business-finance platform through which commercial customers...", "descriptionHtml": "

Senior Software Engineer, Fintech Platform

\n

Location: USA

\n\n

Experience: 5+ years preferred

\n

The role

\n

Hourglass is building a business-...", "descriptionMarkdown": "### Senior Software Engineer, Fintech Platform\n\n**Location:** USA\n\n**Experience:** 5+ years preferred\n\n### The role\n\nHourglass is building a business-finance platform through which commercial customer...", "jobType": "full-time", "postedAt": "2026-09-14T18:03:48Z", "locationNames": [ "New York City", "San Francisco Bay Area" ], "remote": false, "remoteKind": "ONSITE", "wfhFlexible": true, "yearsExperienceMin": 5, "autoPosted": false, "primaryRoleTitle": "Software Engineer", "skills": [ "TypeScript" ], "companyId": "9591839", "companySlug": "hourglass-financial", "companyName": "Hourglass", "companyLogo": "https://photos.wellfound.com/startups/i/9591839-f15e93166aa81b7283a976cbd774d6be-medium_jpg.jpg?buster=1789415876", "companyTagline": "Business moves fast. Money should too", "companySize": "SIZE_1_10", "companySizeLabel": "1-10", "companyBadges": [ "Actively Hiring", "B2B", "Early Stage" ], "companyStage": "early_stage", "companyBusinessType": "B2B", "companyActivelyHiring": true, "companyGrowingFast": false, "companyTopInvestors": false, "companyYcFunded": false, "companyFundingStage": "Early Stage", "salaryCurrency": "USD", "salaryPeriod": "YEAR", "companyWebsite": "https://hourglass.com", "industry": "Finance Technology", "directApply": true, "datePosted": "2026-09-14T18:03:48Z", "jobAddressLocality": "New York", "jobAddressRegion": "New York", "jobAddressCountry": "United States", "latitude": 40.7128, "longitude": -74.0059, "isRepost": false, "matchedSearch": "role=software-engineer@new-york", "source": "wellfound", "scrapedAt": "2026-09-15T21:29:42.417Z" } ``` ### Incremental fields When incremental mode is on, each record also carries: - `changeType` β€” one of `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED`, `EXPIRED`. Default output covers `NEW` / `UPDATED` / `REAPPEARED`; set `emitUnchanged: true` or `emitExpired: true` to opt into the others. - `firstSeenAt`, `lastSeenAt` β€” ISO-8601 timestamps tracking the listing across runs. - `isRepost`, `repostOfId`, `repostDetectedAt` β€” populated when a new listing matches the tracked content of a previously expired one. Set `skipReposts: true` to drop detected reposts from the output. ### How to scrape wellfound.com 1. Go to [Wellfound Startup Job Scraper](https://apify.com/blackfalcondata/wellfound-scraper?fpr=1h3gvi) in Apify Console. 2. Enter a search keyword and optional location filter. 3. Set `maxResults` to control how many results you need. 4. Click **Start** and wait for the run to finish. 5. Export the dataset as JSON, CSV, or Excel. ### Use cases - Extract job data from wellfound.com for market research and competitive analysis. - Track salary trends across regions and categories over time. - Monitor new and changed jobs on scheduled runs without processing the full dataset every time. - Auto-apply or feed apply URLs into your ATS / hiring pipeline. - Research company hiring patterns, employer profiles, and industry distribution. - Use structured location data for regional analysis, mapping, and geo-targeting. - Feed structured data into AI agents, MCP tools, and automated pipelines using compact mode. - Export clean, structured data to dashboards, spreadsheets, or data warehouses. - Analyze skill demand across listings using structured skill tags. - Collect ratings and reviews for reputation monitoring and benchmarking. ### How much does it cost to scrape wellfound.com? Wellfound Startup Job Scraper uses [pay-per-event](https://docs.apify.com/platform/actors/paid-actors/pay-per-event) pricing. You pay a small fee when the run starts and then for each result that is actually produced. - **Run start:** $0.005 per run - **Per result:** $0.003 per job record Example costs: - 10 results: **$0.035** - 25 results: **$0.08** - 100 results: **$0.3** - 200 results: **$0.6** - 500 results: **$1.5** > **Platform usage is billed on top of these prices.** The figures above are Apify event fees only. Compute units and proxy traffic are billed separately by Apify at your actual consumption, and for proxy- or browser-heavy workloads they can exceed the event fees. What you actually pay depends on your own input β€” how many results you request, whether detail enrichment is on, the run memory you choose, and your proxy settings β€” so it cannot be stated as a fixed figure here. Every run reports its exact platform usage on the run detail page. > > The **Actor Start** event is charged once per GB of run memory (minimum one), so a run configured with 2 GB is charged two start events rather than one. #### Example: recurring monitoring savings These examples compare full re-scrapes with incremental runs at different churn rates. Churn is the share of jobs that are new or whose tracked content changed since the previous run. Actual churn depends on your query breadth, source activity, and polling frequency β€” the scenarios below are examples, not predictions. Example setup: 250 jobs per run, daily polling (30 runs/month). Costs scale linearly with the number of jobs. | Churn rate | Full re-scrape run cost | Incremental run cost | Savings vs full re-scrape | Monthly cost after baseline | |---|---:|---:|---:|---:| | 5% β€” stable niche query | $0.76 | $0.04 | $0.71 (94%) | $1.27 | | 15% β€” moderate broad query | $0.76 | $0.12 | $0.64 (84%) | $3.53 | | 30% β€” high-volume aggregator | $0.76 | $0.23 | $0.53 (70%) | $6.90 | Full re-scrape monthly cost at the same cadence: $22.65. First month with incremental costs $1.99 / $4.16 / $7.42 for the 5% / 15% / 30% scenarios because the first run builds baseline state at full cost before incremental savings apply. Platform usage (see the note above) also applies to these figures. Incremental runs consume less of it on result processing, though the fixed per-run overhead stays the same. ### FAQ #### How many results can I get from wellfound.com? The number of results depends on the search query and available jobs on wellfound.com. Use the `maxResults` parameter to control how many results are returned per run. #### Does Wellfound Startup Job Scraper support recurring monitoring? Yes. Enable incremental mode to only receive new or changed jobs on subsequent runs. This is ideal for scheduled monitoring where you want to track changes over time without re-processing the full dataset. #### Can I integrate Wellfound Startup Job Scraper with other apps? Yes. Wellfound Startup Job Scraper works with Apify's [integrations](https://apify.com/integrations?fpr=1h3gvi) to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes. #### Can I use Wellfound Startup Job Scraper with the Apify API? Yes. You can start runs, manage inputs, and retrieve results programmatically through the [Apify API](https://docs.apify.com/api/v2). Client libraries are available for JavaScript, Python, and other languages. #### Can I use Wellfound Startup Job Scraper through an MCP Server? Yes. Apify provides an [MCP Server](https://apify.com/apify/actors-mcp-server?fpr=1h3gvi) that lets AI assistants and agents call this actor directly. Use compact mode, `descriptionMaxLength`, a single `descriptionFormat`, and `excludeEmptyFields` to keep payloads manageable for LLM context windows. #### Is it legal to scrape wellfound.com? This actor extracts publicly available data from wellfound.com. Web scraping of public information is generally considered legal, but you should always review the target site's terms of service and ensure your use case complies with applicable laws and regulations, including GDPR where relevant. #### How do I search by keyword or tech stack? Use `query` for free text (e.g. `"rust engineer"`, `"staff engineer"`, `"product designer"`). A phrase Wellfound has a job category for searches that category; any other phrase keeps only jobs whose title contains its words, and the run log says which of the two happened. Add `roles` for Wellfound's own categories (`software-engineer`, `product-manager`, `data-scientist`, and others) and paste Wellfound search URLs into `searchUrls`. All three combine into one deduplicated run. To narrow further, `includeKeywords` filters on title, description and skills, and `includeCompanies` / `excludeCompanies` keep or drop specific startups. #### How fresh are the job listings? Very fresh. Sampling 48 jobs from the default engineer search in April 2026 yielded: | Age | Share | |---|---| | 1-24 hours | 43% | | 1-7 days | 45% | | 7-30 days | 10% | | > 30 days | 0% | Median age was 1.5 days; the newest listing was 1.25 hours old at scrape time; the oldest was 28 days. Wellfound appears to expire inactive postings aggressively, so you do not see months-old zombie listings that plague broader job aggregators. This makes hourly scheduled runs with `incrementalMode` and `maxAgeMinutes: 60` genuinely useful for real-time monitoring β€” roughly 1-5% of the feed turns over each hour. #### Why are some enrichment fields null? Every listing already carries the full description, compensation, equity, experience, job type, and the company's name, logo, size, stage and badges (for example Actively Hiring, YC Funded, Top Investors, response time and employee ratings). Salary currency and period, company website, industry, office address, coordinates, skills, benefits and apply type come from each job's own page, which the actor opens when `enrichDetail` is on and whenever a radius is set. A field stays null when the job's page does not state it. Deep company-profile fields (founders, funding rounds and amount raised, social links, founded year) are not available from Wellfound's public pages and stay null, with or without `enrichCompany`. #### Your feedback If you have questions, need a feature, or found a bug, please [open an issue](https://apify.com/blackfalcondata/wellfound-scraper/issues?fpr=1h3gvi) on the actor's page in Apify Console. Your feedback helps us improve. ### You might also like - [Actiris Job Scraper \[Just πŸ’°$1.5\] β€” Brussels Public Jobs](https://apify.com/blackfalcondata/actiris-scraper?fpr=1h3gvi) β€” πŸ’° $1.5 per 1,000 jobs. Scrape actiris.brussels β€” the official Brussels public employment service. - [AMS Austria Job Scraper β€” Public Employment Service Jobs](https://apify.com/blackfalcondata/ams-austria-job-scraper?fpr=1h3gvi) β€” Scrape jobs.ams.at, Austria's official AMS public employment portal (alle jobs). Get live. - [APEC Job Scraper \[Just πŸ’°$0.8\] β€” French Executive Jobs](https://apify.com/blackfalcondata/apec-scraper?fpr=1h3gvi) β€” πŸ’° $0.8 per 1,000 jobs, platform usage included. Scrape apec.fr French executive listings β€” every. - [Arbeitsagentur Job Scraper \[πŸ’°$0.45\] β€” German Federal Jobs](https://apify.com/blackfalcondata/arbeitsagentur-jobs-feed?fpr=1h3gvi) β€” πŸ’° from $0.45 per 1,000 jobs. Scrape arbeitsagentur.de β€” Germany's official public employment. - [ArbetsfΓΆrmedlingen Job Scraper \[Just πŸ’°$3\] β€” Sweden Public](https://apify.com/blackfalcondata/arbetsformedlingen-scraper?fpr=1h3gvi) β€” πŸ’° $3 per 1,000 jobs. Scrape arbetsformedlingen.se (Platsbanken) β€” Sweden's official employment. - [Bayt Scraper β€” MENA Jobs with Salary & Skills](https://apify.com/blackfalcondata/bayt-scraper?fpr=1h3gvi) β€” Scrape bayt.com β€” the leading Middle East job board across UAE Β· Saudi Arabia Β· Qatar Β· Egypt & 9. - [BestJobs.eu Scraper \[Just πŸ’°$1.5\] β€” Romania Job Board](https://apify.com/blackfalcondata/bestjobs-eu-scraper?fpr=1h3gvi) β€” πŸ’° $1.5 per 1,000 jobs. Scrape bestjobs.eu β€” a leading Romanian job board β€” export salary ranges Β·. - [Bumeran Scraper \[Just πŸ’°$1\] β€” LATAM Jobs (7 Countries)](https://apify.com/blackfalcondata/bumeran-scraper?fpr=1h3gvi) β€” πŸ’° $1 per 1,000 jobs. Scrape Bumeran Group across LATAM β€” Argentina Β· Chile Β· Ecuador Β· Mexico Β·. - [Indeed Job Scraper β€” 100+ Fields, Salary & 62 Countries](https://apify.com/blackfalcondata/indeed-scraper?fpr=1h3gvi) β€” Scrape every Indeed job with 100+ fields per listing: salary, company ratings, GPS, and full descriptions across 62 countries. ### Getting started with Apify New to Apify? [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=1h3gvi) β€” no credit card required. 1. Sign up β€” $5 platform credit included 2. Open this actor and configure your input 3. Click **Start** β€” export results as JSON, CSV, or Excel Need more later? [See Apify pricing](https://apify.com/pricing?fpr=1h3gvi). ### Disclaimer This actor accesses only publicly available data on wellfound.com. You are responsible for how you use the extracted data β€” in particular any personal information such as names, phone numbers, or email addresses β€” and for complying with Wellfound Startup's terms of use, applicable data-protection law (including the GDPR where it applies), and the anti-spam rules of your jurisdiction. This actor is not affiliated with, endorsed by, or connected to Wellfound Startup. ### Search keywords wellfound scraper, wellfound api, apify wellfound, wellfound data extraction, wellfound startup scraper, wellfound startup api, apify wellfound startup, wellfound startup data extraction, wellfound.com scraper, wellfound.com data, wellfound.com api, job listings scraper, recruitment data, hiring data, job board scraper. # Changelog This Actor's version history is a separate document: https://apify.com/blackfalcondata/wellfound-scraper/changelog.md # Actor input Schema ## `query` (type: `string`): Free-text job search (e.g. "rust engineer", "product designer"). A phrase Wellfound has a job category for searches that category; any other phrase keeps only jobs whose title contains its words. Combine with roles/searchUrls to union multiple searches. ## `roles` (type: `array`): Wellfound's built-in role categories. Each spawns a separate search thread. Common slugs: software-engineer, product-manager, product-designer, data-analyst, growth-marketer, sales-manager, account-manager, hr-manager, operations-manager, financial-analyst, graphic-designer, ui-ux-designer. Free-text β€” you can also try other slugs. ## `searchUrls` (type: `array`): Paste full Wellfound search URLs (e.g. https://wellfound.com/role/l/product-manager/berlin). Each URL spawns a separate search thread. Mix with query/roles freely β€” all deduplicate by job ID. ## `location` (type: `array`): One or more location slugs (e.g. \["new-york", "san-francisco", "berlin"]). Each location Γ— role combination spawns a separate search thread. Ignored for pasted searchUrls (they carry their own location). ## `excludeLocations` (type: `array`): Drop jobs whose locationNames match any of these (substring match, e.g. "India" drops "Bangalore, India"). Applied after fetch. ## `remote` (type: `boolean`): When true, scrapes remote-filtered URLs. Ignored for pasted searchUrls. ## `originLocation` (type: `string`): City name for radius-based filtering (e.g. "San Francisco", "Bengaluru", "London"), or coordinates as "latitude, longitude" (e.g. "40.7128, -74.0060"). Used with radiusMiles or radiusKm. Covers ~110 startup hubs worldwide; a city outside that list skips the radius filter with a warning, so use coordinates for it. ## `radiusMiles` (type: `integer`): Keep only jobs within N miles of originLocation. Each job's own page supplies its coordinates and is fetched automatically when a radius is set, so radius runs take longer; a job whose page gives no coordinates is left out. US-standard unit. ## `radiusKm` (type: `integer`): Kilometer alternative to radiusMiles. If both set, radiusMiles wins. Use this for EU-based searches. ## `jobType` (type: `string`): Filter by employment type. Matches Wellfound's jobType field (substring, case-insensitive). ## `experienceLevel` (type: `string`): Filter by minimum required years of experience. Entry: 0-2, Mid: 2-5, Senior: 5-8, Staff+: 8+. Jobs without experience data are kept. ## `salaryMin` (type: `integer`): Drop jobs whose salary max is below this. 0 = no minimum. Jobs without salary data are dropped when minimum is set. ## `salaryMax` (type: `integer`): Drop jobs whose salary min exceeds this. 0 = no maximum. ## `equityMin` (type: `number`): Drop jobs whose max equity grant is below this percent. 0 = no minimum. Jobs without equity data are dropped when minimum is set. ## `visaSponsorship` (type: `boolean`): Filter by visa sponsorship stance detected from job description heuristics. true = only jobs that explicitly offer sponsorship; false = drop jobs that explicitly refuse sponsorship. Unset = no filter. Detection is conservative β€” jobs without clear phrasing pass when true is not required. ## `includeKeywords` (type: `object`): Require at least one of these keywords. Example: {"keywords":\["rust","golang"],"matchTitle":true,"matchDescription":true,"matchSkills":true}. Matches default to all three fields. ## `excludeKeywords` (type: `object`): Drop jobs containing any of these keywords. Same shape as includeKeywords. ## `fromDate` (type: `string`): Only include jobs posted on or after this date. Accepts YYYY-MM-DD or ISO-8601. ## `toDate` (type: `string`): Only include jobs posted on or before this date. Accepts YYYY-MM-DD or ISO-8601. ## `maxAgeMinutes` (type: `integer`): Only include jobs posted within the last N minutes. 0 = no limit. Pairs well with scheduled runs for real-time monitoring. ## `customFilters` (type: `array`): Array of rules applied to any output field. Each rule: {"field":"","op":"includes|notIncludes|equals|notEquals|gt|gte|lt|lte","value":...}. Example: \[{"field":"companyFundingStage","op":"equals","value":"series-b"}, {"field":"description","op":"notIncludes","value":"wordpress"}]. ## `includeCompanies` (type: `array`): Keep only jobs from companies whose name or Wellfound slug contains one of these (case-insensitive, e.g. "stripe" or "scope-labs"). Applied before charging. ## `excludeCompanies` (type: `array`): Drop jobs from companies whose name or Wellfound slug contains one of these (case-insensitive). Wins over Only These Companies. Applied before charging. ## `maxResults` (type: `integer`): Maximum total job listings to return across all search threads (0 = unlimited). ## `maxPages` (type: `integer`): Maximum SERP pages per search thread (each page has ~42 jobs). Defensive safety bound β€” `maxResults` is the primary record cap. ## `enrichDetail` (type: `boolean`): Core job fields β€” title, full description, compensation, location, remote status, experience level, job type, and company name/logo/size/badges β€” are delivered for every listing with no toggle. Turn this on to also open each job's own page for structured salary currency and period, company website, industry, office address and coordinates, skills, benefits and apply type. One extra page per job, so runs take longer. ## `enrichCompany` (type: `boolean`): Company basics β€” name, logo, slug, size β€” are delivered inline for every listing. This option additionally attempts deep firmographics (funding stage, total raised, investors, founders, social links, founded year, markets). Those deep fields are not currently available and will return null. ## `enrichEmails` (type: `boolean`): Opens each company's own website (home, contact and about pages) for contact emails and its LinkedIn and X profiles. Company websites come from each job's page, so this also turns on Enrich from Detail Pages. Best-effort: many startup sites publish no email. ## `companyOnlyMode` (type: `boolean`): Emit ONE record per unique company instead of one per job, with aggregated jobCount and sample job titles. Ideal for lead-gen / recruiter / sourcer workflows. Incremental mode does not apply (aggregation is per-run). Pairs well with enrichDetail for company website and industry. ## `descriptionMaxLength` (type: `integer`): Truncate job description to this many characters. 0 = no truncation. ## `compact` (type: `boolean`): Output only core fields (id, title, companyName, portalUrl, locationNames, remote, compensation, postedAt). For AI-agent/MCP workflows. ## `incrementalMode` (type: `boolean`): Compare against previous run state. Only emits NEW and UPDATED jobs. Requires stateKey. ## `stateKey` (type: `string`): Stable identifier for the tracked search universe (e.g. 'us-software-remote'). Required when incrementalMode is true. IMPORTANT: changing your filters (roles, searchUrls, location) will cause jobs outside the new universe to be marked EXPIRED. Use a NEW stateKey if you change search scope. ## `emitUnchanged` (type: `boolean`): When incremental, also emit records that have not changed since last run. ## `emitExpired` (type: `boolean`): When incremental, also emit records no longer found (job removed or expired). ## `skipReposts` (type: `boolean`): When enabled, suppress jobs that appear to be reposts of previously seen (and now expired) jobs based on content-hash matching. ## `telegramToken` (type: `string`): Telegram bot token from @BotFather. Sends notifications when new jobs are emitted. Pairs well with incrementalMode for real-time alerts. ## `telegramChatId` (type: `string`): Chat ID (from @userinfobot) or channel ID (starts with -100 for channels). Required when telegramToken is set. ## `slackWebhookUrl` (type: `string`): Slack incoming webhook URL (Slack App β†’ Incoming Webhooks β†’ Add New Webhook). Formats jobs as Slack blocks with company, salary, funding stage, and location. ## `discordWebhookUrl` (type: `string`): Discord channel webhook URL (Server Settings β†’ Integrations β†’ Webhooks β†’ New Webhook). Sends rich embeds colour-coded by change type (green=NEW, amber=UPDATED). ## `whatsappPhoneNumberId` (type: `string`): WhatsApp Business phone number ID from Meta Business Manager (the numeric ID next to your number β€” NOT the phone number itself). Free service-conversation messages within 24 hours of last user-initiated contact. ## `whatsappAccessToken` (type: `string`): Meta Cloud API access token with whatsapp_business_messaging scope. Get a permanent token from a system user in Meta Business Manager. ## `whatsappTo` (type: `string`): Recipient phone number in E.164 format (e.g. +4512345678). The recipient must have messaged your business number within the last 24 hours. ## `webhookUrl` (type: `string`): Universal escape hatch for n8n / Make / Zapier / custom HTTP backends. Receives a JSON POST { metadata, items } per run. Single attempt, 15 s timeout. ## `webhookHeaders` (type: `object`): Additional HTTP headers sent with the generic webhook POST (e.g. {"Authorization":"Bearer ..."}). ## `notificationLimit` (type: `integer`): Maximum number of jobs to send per notification batch. Prevents spam on large result sets. ## `includeRunMetadata` (type: `boolean`): Prepend a one-line summary (search label + total count) to each notification batch. ## `notifyOnlyChanges` (type: `boolean`): When ON (default) AND incrementalMode is ON, send notifications only for NEW and UPDATED jobs. Without incrementalMode, this has no effect (all emitted jobs are notified). ## `proxyConfiguration` (type: `object`): Wellfound can reject automated traffic. The default network settings are tuned for reliable runs, and advanced users can provide their own connection settings. ## `descriptionFormat` (type: `string`): Pick a single description representation. `all` keeps every variant; `text` / `html` / `markdown` drop the others. ## `excludeEmptyFields` (type: `boolean`): Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards. ## `appConnector` (type: `string`): Optional. Pick a connected app under Settings β†’ API & Integrations to receive your results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog. ## `mcpIssueTeam` (type: `string`): Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one. ## `startUrls` (type: `array`): One or more direct search or listing detail URLs to process. When set, other search filters are ignored. ## `cityName` (type: `string`): City name (e.g. "Paris", "Lyon"). Resolved to the nearest known city. ## `lat` (type: `number`): GPS latitude. Pair with lon. Ignored when cityName is set. ## `lon` (type: `number`): GPS longitude. Pair with lat. ## Actor input object example ```json { "query": "software engineer", "remote": false, "radiusMiles": 0, "radiusKm": 0, "salaryMin": 0, "salaryMax": 0, "equityMin": 0, "maxAgeMinutes": 0, "maxResults": 100, "maxPages": 10, "enrichDetail": false, "enrichCompany": false, "enrichEmails": false, "companyOnlyMode": false, "descriptionMaxLength": 0, "compact": false, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "skipReposts": false, "notificationLimit": 5, "includeRunMetadata": true, "notifyOnlyChanges": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" }, "descriptionFormat": "all", "excludeEmptyFields": false } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "software engineer", "maxResults": 100, "enrichDetail": false, "enrichCompany": false, "enrichEmails": false, "companyOnlyMode": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" }, "descriptionFormat": "all", "excludeEmptyFields": false }; // Run the Actor and wait for it to finish const run = await client.actor("blackfalcondata/wellfound-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "software engineer", "maxResults": 100, "enrichDetail": False, "enrichCompany": False, "enrichEmails": False, "companyOnlyMode": False, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, "descriptionFormat": "all", "excludeEmptyFields": False, } # Run the Actor and wait for it to finish run = client.actor("blackfalcondata/wellfound-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "software engineer", "maxResults": 100, "enrichDetail": false, "enrichCompany": false, "enrichEmails": false, "companyOnlyMode": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" }, "descriptionFormat": "all", "excludeEmptyFields": false }' | apify call blackfalcondata/wellfound-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,blackfalcondata/wellfound-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/jV4Y8h6j3AqVj5Qur/builds/OAgaMoizo9mf4SzUg/openapi.json