# Wellfound (AngelList) Startup Jobs Scraper — Salary & Remote (`nomad-agent/wellfound-scraper`) Actor

Scrape startup jobs from wellfound.com (formerly AngelList Talent): title, company, location, salary (min/max/currency), equity, remote flag, job type, posted date and apply URL. A real browser via residential proxy clears DataDome bot protection. Delta mode returns only new postings.

- **URL**: https://apify.com/nomad-agent/wellfound-scraper.md
- **Developed by:** [Nomad Dev](https://apify.com/nomad-agent) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 wellfound job results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Wellfound Job Scraper — Startup Jobs

Scrape live startup job openings from wellfound.com (formerly AngelList Talent) into clean, structured JSON.

> **Claude / Codex skill to describe and setup this actor: [SKILL.md](https://github.com/Exdenta/OinkAIJobSearch/blob/main/skill/wellfound-scraper/SKILL.md)**

### What Wellfound jobs data does this scraper extract?

Each result is one flat JSON record per job posting:

| Field | Meaning |
|---|---|
| `id` | Numeric posting id parsed from the URL (e.g. `1234567` from `.../jobs/1234567-role-slug`); blank if the URL doesn't carry one |
| `title` | Job title as posted |
| `company` | Hiring company name (may be blank on pages that don't expose structured data) |
| `location` | Location text, including remote hints (may be blank on pages that don't expose structured data) |
| `isRemote` | Boolean — true when the posting carries a remote signal (schema.org `jobLocationType` = TELECOMMUTE, a remote keyword in the location, or applicant-location-requirements with no office); null when the page fell back to meta extraction |
| `salary` | Human-readable compensation, e.g. `"USD 120,000 – 160,000/year"` (from JSON-LD `baseSalary`); null when the posting doesn't expose pay |
| `salaryMin` / `salaryMax` | Numeric lower/upper bounds of the pay range (null when unexposed) |
| `salaryCurrency` | ISO currency code of the salary, e.g. `"USD"` (null when unexposed) |
| `equity` | Equity percentage range, e.g. `"0.1% - 1.0%"`, parsed from the description when it mentions equity (best-effort; null when none stated) |
| `jobType` | Employment type from schema.org `employmentType` (e.g. `FULL_TIME`, `CONTRACTOR`, `INTERN`); null when unexposed |
| `companyLogo` | Hiring company's logo URL from JSON-LD `hiringOrganization.logo` (null when absent) |
| `url` | Direct link to the posting |
| `postedAt` | Posting date where wellfound.com provides it (may be blank) |
| `snippet` | Short description excerpt |
| `source` | Always `"wellfound"` — useful when merging with other job-board datasets |

### How to scrape Wellfound jobs with this Actor

1. Click **Try for free** / **Run** with the defaults, or set a `keyword` to narrow the listing.
2. The Actor uses ordinary browser rendering through the configured proxy. If Wellfound presents a CAPTCHA or anti-bot challenge, the run stops honestly without attempting to clear or evade it.
3. Run it and export the dataset as JSON, CSV or Excel, or read it over the [API](https://docs.apify.com/api/v2).

Run it from your own code:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("nomad-agent/wellfound-scraper").call(run_input={"maxItems": 30})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"], "—", item["company"], item["url"])
```

Or a single HTTP call that runs the Actor and returns items in one response:

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/nomad-agent~wellfound-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"maxItems": 30}'
```

### Input

| Field | Type | Default | Notes |
|---|---|---|---|
| `keyword` | string | `""` | Optional role query appended to the listing URL (e.g. "frontend engineer", "react"). Leave empty to scrape the default jobs listing. |
| `maxItems` | integer | `30` | Maximum number of postings to return. |
| `postedSince` | integer | `0` | Only keep postings posted within this many days. Postings whose date wasn't exposed by the page are kept, not dropped. `0` disables the filter. |
| `titleExclude` | array of strings | `[]` | Drop postings whose title contains any of these words/phrases (case-insensitive). |
| `companyExclude` | array of strings | `[]` | Drop postings whose company name contains any of these words/phrases (case-insensitive). |
| `remoteOnly` | boolean | `false` | Keep only postings flagged remote (`isRemote` true). Postings without a confirmed remote signal are dropped when on. |
| `jobType` | string | `""` | Keep only postings of this employment type (`Full-time`, `Part-time`, `Contract`, `Internship`, `Temporary`). Unknown types are kept, not dropped. Empty = all types. |
| `salaryMin` | integer | `0` | Keep only postings whose pay reaches at least this amount (compared to the top of the range). Postings without an exposed salary are kept. `0` disables. |
| `salaryMax` | integer | `0` | Keep only postings whose pay starts at or below this amount (compared to the bottom of the range). Postings without an exposed salary are kept. `0` disables. |
| `proxyConfiguration` | object | Residential proxy group | Ordinary proxy transport used to load public pages. It is not used to solve or evade a presented challenge. |
| `startUrl` | string | `https://wellfound.com/jobs` | Advanced: override only if you want to start from a specific saved search or filtered listing URL. |
| `detailUrlContains` | string | `/jobs/` | Advanced: override only if wellfound.com changes its URL structure and the actor stops finding postings. |
| `useResidentialProxy` | boolean | `true` | Deprecated — superseded by `proxyConfiguration` above. Kept for backward compatibility; only used when `proxyConfiguration` is left unset. |

### Output example

```json
{
  "id": "2847193",
  "title": "Senior Backend Engineer",
  "company": "Acme Startup",
  "location": "Remote (US)",
  "isRemote": true,
  "salary": "USD 140,000 – 180,000/year",
  "salaryMin": 140000,
  "salaryMax": 180000,
  "salaryCurrency": "USD",
  "equity": "0.1% - 0.5%",
  "jobType": "FULL_TIME",
  "companyLogo": "https://photos.wellfound.com/.../acme-logo.png",
  "url": "https://wellfound.com/jobs/2847193-senior-backend-engineer",
  "postedAt": "2026-06-29",
  "snippet": "We're looking for a senior backend engineer to help scale our platform...",
  "source": "wellfound"
}
```

### Pricing

Pay per event: **$0.05 per Actor start** and **$0.004 per job returned**.
100 jobs ≈ $0.45. No subscription, no rental — you pay only for what you fetch.

Export results as JSON, CSV or Excel; connect via Make, Zapier or n8n; call directly with `run-sync-get-dataset-items`; or plug into AI agents through the Apify MCP server.

### Use cases

- Startup-hiring intelligence — track who's hiring across the Wellfound network
- Job-alert bots and boards focused on startup / VC-backed roles
- Recruiting and sourcing pipelines targeting early-stage companies
- Labour-market research on the startup ecosystem

### FAQ

**Is it legal to scrape Wellfound?**
This Actor reads only publicly available job postings — data any visitor can see without logging in. No personal data behind authentication is touched. Review the target site's terms and your local regulations for your specific use case.

**Do I need an account on the target site?**
No. Postings are fetched from public pages — no login, cookies or session tokens.

**Why do some runs return fewer results than `maxItems`?**
wellfound.com can challenge a listing or detail page even through a residential proxy. The Actor does not clear or evade those challenges, so extraction is best-effort and the run records a degraded source outcome. If a run returns 0 postings, enable the **debug** input to save a page snapshot for distinguishing a challenge from a genuinely empty listing.

**How fresh is the data?**
Every run fetches live listings — there's no caching layer.

**How can I identify newly listed jobs?**
Schedule the Actor and compare its full current snapshot downstream.

**How many jobs can I get?**
`maxItems` caps the run. The listing page is paginated newest-first.

**Something broken or missing?**
Open an issue on the Actor's **Issues** tab — it is monitored and reliability fixes ship fast.

### Related Actors

- [Y Combinator Jobs Scraper — Work at a Startup](https://apify.com/nomad-agent/ycombinator-was-scraper)
- [LinkedIn Jobs Scraper — No Login, No Cookies](https://apify.com/nomad-agent/linkedin-scraper)
- [Remote Jobs Scraper — RemoteOK Remotive WWR](https://apify.com/nomad-agent/remote-boards-scraper)
- [Company Careers Scraper — Greenhouse Lever Ashby](https://apify.com/nomad-agent/company-careers-bundle)

***

**From the maker of [Oink](https://github.com/Exdenta/OinkAIJobSearch)** — an open-source, AI-powered job-search bot for Telegram that runs on these Actors. [Try the free bot](https://t.me/job_search_everyday_bot), get a managed instance at [oinkjobsearch.com](https://oinkjobsearch.com), or browse the [full catalog of 50+ Actors](https://apify.com/nomad-agent).

# Actor input Schema

## `keyword` (type: `string`):

Optional role query appended to the listing URL (e.g. <code>frontend engineer</code>, <code>react</code>). Leave empty to scrape the default jobs listing.

## `maxItems` (type: `integer`):

Maximum number of postings to return.

## `postedSince` (type: `integer`):

Only keep postings posted within this many days. Postings whose posting date wellfound.com didn't expose are still kept, not dropped. Leave at 0 to disable this filter.

## `titleExclude` (type: `array`):

Drop postings whose title contains any of these words/phrases (case-insensitive). Leave empty to keep every title.

## `companyExclude` (type: `array`):

Drop postings whose company name contains any of these words/phrases (case-insensitive). Leave empty to keep every company.

## `remoteOnly` (type: `boolean`):

Keep only postings Wellfound flags as remote (the <code>isRemote</code> output field is true). Postings without a confirmed remote signal are dropped when this is on.

## `jobType` (type: `string`):

Keep only postings of this employment type (matched against the <code>jobType</code> output field, from schema.org <code>employmentType</code>). Leave empty for all types. Postings whose type wellfound.com didn't expose are kept, not dropped.

## `salaryMin` (type: `integer`):

Keep only postings whose salary reaches at least this amount (compared against the top of the posting's range). Postings without an exposed salary are kept, not dropped. Leave at 0 to disable.

## `salaryMax` (type: `integer`):

Keep only postings whose salary starts at or below this amount (compared against the bottom of the posting's range). Postings without an exposed salary are kept, not dropped. Leave at 0 to disable.

## `proxyConfiguration` (type: `object`):

Proxy used to load wellfound.com. Required: keep the Residential proxy group selected — Apify Residential needs a paid Apify plan, and its bandwidth is billed separately per your plan's proxy rates. wellfound.com blocks non-residential / non-browser traffic via DataDome: measured 2026-08-01, 15 of 15 requests from the Apify datacenter proxy came back HTTP 403, so a run without Residential returns nothing.

## `startUrl` (type: `string`):

The listing page the actor opens first and harvests job links from. Change this only if you want to start from a specific saved search or filtered listing URL on wellfound.com instead of the default jobs page.

## `detailUrlContains` (type: `string`):

Only follow links whose URL contains this text — used to tell individual job postings apart from other links on the listing page. The default (<code>/jobs/</code>) matches wellfound.com's current URL structure; change it only if the site's URL structure changes and the actor stops finding postings.

## `useResidentialProxy` (type: `boolean`):

Deprecated — use the <code>Proxy configuration</code> field above instead. Kept for backward compatibility: if Proxy configuration is left unset, this flag decides whether the actor routes through Apify's Residential proxy group (required to pass DataDome) or connects directly (will almost certainly be blocked).

## `debug` (type: `boolean`):

When a listing page yields 0 detail links, save the rendered HTML + a full-page screenshot to this run's key-value store (keys DEBUG\_LISTING\_HTML / DEBUG\_LISTING\_PNG) so you can see what the browser saw. Off by default.

## Actor input object example

```json
{
  "keyword": "frontend engineer",
  "maxItems": 30,
  "postedSince": 0,
  "titleExclude": [],
  "companyExclude": [],
  "remoteOnly": false,
  "jobType": "",
  "salaryMin": 0,
  "salaryMax": 0,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "startUrl": "https://wellfound.com/jobs",
  "detailUrlContains": "/jobs/",
  "useResidentialProxy": true,
  "debug": false
}
```

# Actor output Schema

## `dataset` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "titleExclude": [],
    "companyExclude": [],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nomad-agent/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "titleExclude": [],
    "companyExclude": [],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("nomad-agent/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 '{
  "titleExclude": [],
  "companyExclude": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call nomad-agent/wellfound-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nomad-agent/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 <APIFY_API_TOKEN>` 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/cLOYFtqDtZX8XV8Ip/builds/fLEbuJIlUHN9aJsVk/openapi.json
