Wellfound Jobs MCP server

💼 Wellfound Jobs API: A Startup Jobs API for Salary and Equity Data

A startup jobs API for Wellfound (formerly AngelList Talent). Search by role, location, and remote status, and get one clean JSON row per job: the full description, parsed salary and equity ranges, and the hiring startup's signals including Y Combinator backing, top investors, and funding stage.

Actor: https://apify.com/johnvc/wellfound-jobs-api?fpr=9n7kx3

Video Walkthrough

Text walkthrough

This jobs API turns Wellfound's public startup listings into structured data. You give it roles (Wellfound slugs like software-engineer, or plain words like "software" and "pm", which are mapped for you) and optionally locations such as san-francisco, new-york, or london. Each role and location pair becomes its own search, and the API walks the paginated results for you.

Every row comes back with title, url, the full markdown description, and compensation parsed into real numbers: salaryMin, salaryMax, salaryCurrency, equityMin, and equityMax. The attached company object carries name, size, tagline, stage, and the badges Wellfound publishes, so you can keep only remote startup jobs, only YC startup jobs, or only companies actively hiring.

A concrete use case: set remoteOnly with minSalary to build a weekly feed of remote startup jobs above a pay floor, then turn on fetchJobDetails to add benefits, industry, the company's own website, and geo coordinates for the shortlist you care about.

Quick Start

Prerequisites

• Python 3.11 or newer
• uv for package management
• An Apify API token. Get your free API key at https://apify.com?fpr=9n7kx3

git clone https://github.com/johnisanerd/Apify-Wellfound-Jobs-API.git
cd Apify-Wellfound-Jobs-API
uv sync
cp .env.example .env       # then paste your token into .env
uv run python wellfound-jobs-api-example.py

Alternative: set the API key directly

export APIFY_API_TOKEN="your_apify_api_token_here"
uv run python wellfound-jobs-api-example.py

Why use this Wellfound Jobs API?

• Full descriptions included. The complete job description comes back in the listing row, not behind an extra fetch.
• Salary and equity as numbers. Wellfound publishes pay as a string like $135k - $175k * 0.05% - 0.25%. This API parses it into salaryMin, salaryMax, equityMin, and equityMax so you can sort and filter.
• Startup signals you can filter on. ycOnly, topInvestorsOnly, activelyHiringOnly, and companyStage come straight from the badges Wellfound shows.
• Pay only for what you get. Billing is per delivered job, with separate small charges for the description and for optional detail enrichment. Jobs removed by your filters are never charged.

Features

Core capabilities

• Search by role, location, and remote status, with automatic pagination
• Free-text role input mapped onto real Wellfound slugs ("software" to software-engineer)
• Keyword include and exclude filters over title, description, company, and location
• Salary, equity, job type, and experience filters
• Startup-signal filters: Y Combinator, top investors, actively hiring, funding stage
• Optional detail enrichment: benefits, industry, company website, geo, structured salary
• Paste any Wellfound search URL directly with startUrls

Data quality

• One row per job, deduplicated across every search thread in the run
• ISO timestamps for when each job went live
• Runs that return nothing explain why in the dataset, not just in the log

Usage examples

Basic example

run_input = {"roles": ["software-engineer"], "maxItems": 5}

Remote startup jobs

run_input = {"roles": ["software-engineer"], "remoteOnly": True, "maxItems": 25}

Shortened. The full README is on GitHub.