Wellfound Jobs API
A startup jobs API for Wellfound (formerly AngelList Talent). Search by role, location, and remote status, and get the full job description, salary and equity parsed into numbers, and the hiring startup's signals including Y Combinator backing, top investors, and funding stage. Pay per job, MCP-ready for Claude and AI agents.
Input parameters
| PARAMETER | TYPE | REQ | DEFAULT | DESCRIPTION |
|---|---|---|---|---|
| roles | string[] | no | — | Role categories to search. Wellfound slugs such as software-engineer, or plain words that are mapped for you ('software' becomes software-engineer). |
| locations | string[] | no | — | Location slugs such as san-francisco, new-york, london, india. |
| remoteOnly | boolean | no | False | Return only jobs flagged as remote. |
| keyword | string | no | — | Narrow results to jobs containing this phrase across title, description, company and location. |
| minSalary | integer | no | — | Drop jobs whose maximum salary is below this, in USD per year. |
| minEquity | integer | no | — | Drop jobs whose maximum equity grant is below this percent. |
| ycOnly | boolean | no | False | Keep only jobs at Y Combinator-backed startups. |
| topInvestorsOnly | boolean | no | False | Keep only startups flagged as backed by top investors. |
| companyStage | string | no | — | Keep only companies at this funding stage, for example early_stage. |
| includeDescription | boolean | no | True | Include the full markdown job description in each row. |
| fetchJobDetails | boolean | no | False | Fetch each job's detail page for benefits, industry, company website, geo and structured salary. |
| maxItems | integer | no | 50 | Maximum number of jobs to return across all searches. |
Worked examples
{
"roles": ["software-engineer"],
"maxItems": 25
}
{
"roles": ["software-engineer"],
"remoteOnly": true,
"minSalary": 150000
}
{
"roles": ["software-engineer"],
"ycOnly": true
}
Coverage
Code
curl
curl -X POST "https://api.apify.com/v2/acts/johnvc~wellfound-jobs-api/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"roles": ["software-engineer"], "maxItems": 25}'
Python
from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/wellfound-jobs-api").call(
run_input={'roles': ['software-engineer'], 'maxItems': 25}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
MCP
Apify's hosted MCP server loads this source from the URL below as the tool johnvc--wellfound-jobs-api. Sign in to Apify when your client asks (OAuth), or send an Apify token as an Authorization: Bearer header.
https://mcp.apify.com/?tools=johnvc/wellfound-jobs-api
Questions people ask
What does the Wellfound Jobs API return for each job?
The full job description in Markdown, salary and equity parsed into numbers, and the hiring startup's signals, including Y Combinator backing, top investors, actively hiring status and funding stage.
How is the Wellfound Jobs API priced?
A job listing costs $0.001, the job description adds $0.0006 per job, and detail enrichment with fetchJobDetails adds $0.0036 per job. There is a free tier on Apify, and maxItems, 50 by default, caps the run.
How do I find remote startup jobs with the Wellfound Jobs API?
Set remoteOnly to true alongside your roles, and add minSalary to drop jobs whose maximum salary is below a USD per year floor. The example uses software-engineer with a 150000 floor.
Can the Wellfound Jobs API filter to YC-backed startups?
Yes. Set ycOnly to true to keep only jobs at Y Combinator-backed startups. You can also use topInvestorsOnly, companyStage such as early_stage, and minEquity to filter by equity grant percent.
What do the roles and locations inputs in the Wellfound Jobs API take?
Roles take Wellfound slugs such as software-engineer, or plain words like software that are mapped for you. Locations take slugs such as san-francisco, new-york, london or india.
Can Claude or an AI agent use the Wellfound Jobs API?
Yes. It is exposed as an MCP tool on Apify's hosted MCP server for Claude, Cursor and other agents, and it can also be called over REST.