wellfound-jobs

💼 Wellfound Jobs API：用于获取薪资和股权数据的初创公司职位 API

适用于 Wellfound（前身为 AngelList Talent）的初创公司职位 API。按职位、地点和远程状态搜索，每个职位返回一条简洁的 JSON 记录：完整职位描述、解析后的薪资和股权范围，以及招聘初创公司的相关信息，包括是否获得 Y Combinator 支持、顶级投资者和融资阶段。

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

视频演示

文字演示

这个职位 API 会将 Wellfound 上公开的初创公司职位列表转换为结构化数据。你可以传入 roles（Wellfound 的 slug，例如 software-engineer，也可以传入普通词语，例如 “software” 和 “pm”，系统会为你映射）以及可选的 locations，例如 san-francisco、new-york 或 london。每个职位和地点组合都会成为一次独立搜索，API 会为你遍历分页结果。

每条记录都会包含 title、url、完整的 Markdown description，以及解析为实际数值的薪酬字段：salaryMin、salaryMax、salaryCurrency、equityMin 和 equityMax。附带的 company 对象包含 name、size、tagline、stage 以及 Wellfound 发布的徽章，因此你可以只保留远程初创公司职位、仅保留 YC 初创公司职位，或只筛选正在积极招聘的公司。

一个具体用例：设置 remoteOnly 和 minSalary，构建每周远程初创公司职位动态列表，并设定最低薪资门槛；然后启用 fetchJobDetails，为你关注的职位补充福利、行业、公司官网和地理坐标。

快速开始

前提条件

• Python 3.11 或更高版本
• 用于包管理的 uv
• Apify API 令牌。前往 https://apify.com?fpr=9n7kx3 免费获取 API 密钥

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

替代方案：直接设置 API 密钥

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

为什么使用这个 Wellfound Jobs API？

• 包含完整职位描述。 完整职位描述会随职位列表一同返回，无需额外获取。
• 薪资和股权以数值形式提供。 Wellfound 发布的薪酬信息是类似 $135k - $175k * 0.05% - 0.25% 的字符串。此 API 会将其解析为 salaryMin、salaryMax、equityMin 和 equityMax，方便你排序和筛选。
• 可筛选的初创公司信号。 ycOnly、topInvestorsOnly、activelyHiringOnly 和 companyStage 均直接来自 Wellfound 展示的徽章。
• 只为实际获取的内容付费。 按交付的职位计费，职位描述和可选的详细信息补充另行收取少量费用。被筛选条件排除的职位不会产生费用。

功能

核心功能

• 按职位、地点和远程状态搜索，并自动处理分页
• 将自由文本职位输入映射到 Wellfound 的实际 slug（“software” 映射为 software-engineer）
• 按职位标题、描述、公司和地点筛选关键词，可设置包含或排除条件
• 薪资、股权、职位类型和经验筛选
• 初创公司信号筛选：Y Combinator、顶级投资者、积极招聘状态、融资阶段
• 可选的详细信息补充：福利、行业、公司官网、地理信息、结构化薪资
• 通过 startUrls 直接粘贴任意 Wellfound 搜索 URL

数据质量

• 每个职位对应一条记录，并在本次运行的所有搜索线程中去重
• 提供每个职位上线时间的 ISO 时间戳
• 如果运行没有返回结果，数据集会说明原因，而不仅仅是在日志中提示

使用示例

基本示例

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

远程初创公司职位

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

薪资超过 $150k 的 YC 初创公司职位

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

指定城市的初创公司职位，并补充详细信息

run_input = {
    "roles": ["software-engineer"],
    "locations": ["san-francisco"],
    "fetchJobDetails": True,
    "maxItems": 10,
}

输入参数

参数	类型	说明
roles	array	要搜索的职位类别。Wellfound slug 或会映射为对应职位的普通词语（例如将 "software" 映射为 software-engineer）。
locations	array	地点 slug，例如 san-francisco、new-york、london、india。
remoteOnly	boolean	仅限标记为远程办公的职位。
keyword	string	将结果缩小到包含此短语的职位。Wellfound 没有全站自由文本搜索，因此此参数会筛选本次运行抓取的页面。
excludeKeyword	string	排除职位名称或描述中包含此短语的职位。
jobType	string	full-time、part-time、contract、internship。
minSalary / maxSalary	integer	年薪（美元）的最低和最高限额。
minEquity	integer	最低股权授予比例。
ycOnly	boolean	仅限由 Y Combinator 支持的公司。
topInvestorsOnly	boolean	仅限标记为由顶级投资者支持的公司。
activelyHiringOnly	boolean	仅限带有积极招聘徽章的公司。
companyStage	string	融资阶段，例如 early_stage。
includeDescription	boolean	包含完整的 Markdown 描述。默认值为 true。
fetchJobDetails	boolean	抓取每个职位的详情页，以获取更多字段。默认值为 false。
maxItems	integer	所有搜索返回的职位数量上限。
maxPagesPerSearch	integer	每个搜索线程的页面安全上限。
startUrls	array	粘贴 Wellfound 搜索 URL，直接抓取。

输出格式

{
  "result_type": "job",
  "id": "4353862",
  "title": "Product Manager",
  "url": "https://wellfound.com/jobs/4353862-product-manager",
  "description": "### About the role ...",
  "compensationRaw": "$130k - $200k * 0.15% - 0.25%",
  "salaryMin": 130000,
  "salaryMax": 200000,
  "salaryCurrency": "USD",
  "equityMin": 0.15,
  "equityMax": 0.25,
  "jobType": "full-time",
  "remote": false,
  "remoteKind": "ONSITE",
  "locationNames": ["San Francisco"],
  "postedAt": "2026-07-28T20:58:57+00:00",
  "company": {
    "name": "Agave API",
    "slug": "agave-api",
    "size": "SIZE_11_50",
    "tagline": "Unified API for construction software",
    "stage": "early_stage",
    "ycFunded": true,
    "topInvestors": true,
    "activelyHiring": true
  }
}

启用 fetchJobDetails 后，行中还会包含 benefits、industry、companyWebsite、geo、detailSalary 和 applicantLocationRequirements。

设置计划

保存包含搜索条件的任务，然后添加一个计划，以建立新职位发布记录。可用的 cron 表达式：0 7 * * * 表示每天早上 7 点，0 6 * * 1 表示每周一。

🤖 向 AI 助手询问此 Actor

在你选择的 AI 中打开一条关于 Wellfound Jobs API 的即发提示词：

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

人们还会搜索

如何通过 API 获取初创公司职位数据？ 通过 Python、Apify API 或任何 MCP 客户端运行此 Actor。它会返回 JSON、CSV 或 Excel。

如何查找远程初创公司职位？ 将 remoteOnly 设为 true。每行都包含 remote、remoteKind 和 acceptedRemoteLocationNames。

如何查找 Y Combinator 初创公司职位？ 将 ycOnly 设为 true，或按 topInvestorsOnly 和 companyStage 筛选。

可以获取特定城市的初创公司职位吗？ 可以。将 roles 与 locations 组合使用，例如 san-francisco、new-york 或 london。

其中包含薪资和股权信息吗？ 包含，既有原始文本，也会解析为数值范围。

求职者可以免费使用 Wellfound 吗？ 可以。此 API 会读取访客能看到的同一批公开页面，并将其作为结构化数据返回。

🪢 在 n8n 中使用

此 API 可作为 n8n 社区节点使用：n8n-nodes-wellfound-jobs-api。在 n8n 中：Settings, Community Nodes, Install，输入 n8n-nodes-wellfound-jobs-api，接受风险提示并重启。随后，Wellfound Jobs 节点会出现在节点选择器中，并可作为 AI Agent 工具使用。

---

在 Claude Cowork Desktop 中安装

Cowork 是桌面应用的自动化模式。若要将 Wellfound Jobs API 作为工具提供给它，请添加 Apify MCP 服务作为连接器。

1. 打开 Claude 桌面应用，然后前往 Settings → Connectors（或前往 Settings → Developer → Edit Config，直接编辑 claude_desktop_config.json）。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. 添加 Apify MCP 服务，并且只预加载此 Actor：

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api"
      ]
    }
  }
}

3. 重启应用。Cowork 首次调用工具时，请在浏览器中完成 OAuth 提示，或在连接器设置中添加 Apify API 令牌以跳过 OAuth。
4. 在 Cowork 聊天中确认工具可用，并要求它运行 Wellfound Jobs API。

下载桌面应用并开始免费试用：https://claude.ai/referral/uIlpa7nPLg 更多帮助：https://docs.apify.com/platform/integrations/claude-desktop

---

在 Claude Code 中安装

Claude Code 是命令行工具。使用一条命令添加 Actor 的 MCP 服务：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api"

若要使用令牌而非浏览器 OAuth：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

然后运行 claude mcp list 进行验证，或在会话中运行 /mcp。要求 Claude Code 调用 Wellfound Jobs API。

免费试用 Claude Code：https://claude.ai/referral/uIlpa7nPLg Claude Code MCP 文档：https://code.claude.com/docs/en/mcp

---

在 Claude（网站）中安装

在 claude.ai 上，将 Apify 添加为连接器，然后只启用此 Actor 的工具。

1. 前往 Settings → Connectors → Browse connectors，搜索 Apify MCP server。安装它（如有提示，请启用或更新）。
2. 连接时，使用 Apify API 令牌进行身份验证，并启用工具 johnvc/wellfound-jobs-api。
3. 在任意聊天中，打开 + → Connectors 并启用 Apify。
4. 或者，选择 Add custom connector 并粘贴完整的 MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api，并在出现提示时使用 OAuth。
5. 要求 Claude 运行 Wellfound Jobs API。

在网页上打开 Claude：https://claude.ai/referral/uIlpa7nPLg

---

在 Cursor 中安装

Cursor 从项目文件 .cursor/mcp.json 中读取 MCP 服务。

1. 在项目中创建 .cursor/mcp.json：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api"
    }
  }
}

2. 如果更倾向于使用令牌身份验证，而不是浏览器 OAuth，请添加一个标头：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. 打开 Cursor → Settings → MCP，确认 apify 服务已连接（绿点）。
4. 在 Composer 或 Chat 中，让 Cursor 调用 Wellfound Jobs API。

刚接触 Cursor？在此获取：https://cursor.com/referral?code=XQP4VBLI3NNX

---

在 ChatGPT 中安装

ChatGPT 通过开发者模式连接到 Apify MCP 服务（ChatGPT Pro、Plus、Business、Enterprise 和 Education 套餐均可使用）。

1. 点击个人资料图标，然后前往 Settings > Apps。如果看不到 Create app 按钮，请打开 Advanced settings 并启用 Developer mode。
2. 点击 Create app 并填写表单：
   • Name： Apify
   • MCP Server URL： https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api
   • Authentication： OAuth
3. 点击 Create，并通过 Apify 授权连接。
4. 若要在对话中使用此应用，请点击聊天中的 +，选择 Developer mode，然后选择 Apify。

更多帮助：https://docs.apify.com/platform/integrations/mcp

---

用心打造

使用 Wellfound Jobs API 为招聘、市场研究和潜在客户开发工作流提供支持，获取可靠、结构化的结果。

最后更新：2026.10.27