# Wellfound Jobs API - Startup Jobs, Salary & Equity (`johnvc/wellfound-jobs-api`) Actor

Wellfound (formerly AngelList) startup jobs API. Search by role, location, and remote status; get full descriptions, parsed salary and equity, company data, and startup signals (YC, top investors, stage). Pay per job. MCP-ready for Claude and AI agents.

- **URL**: https://apify.com/johnvc/wellfound-jobs-api.md
- **Developed by:** [John](https://apify.com/johnvc) (community)
- **Categories:** Jobs, Lead generation, Agents
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 job listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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 Jobs API - Startup Jobs, Salary & Equity

The Wellfound Jobs API is a startup jobs API that returns listings from Wellfound (formerly AngelList Talent) as structured JSON. Search by role, location, and remote status, and get the full job description, parsed salary and equity ranges, company details, and startup signals like Y Combinator backing, top investors, and funding stage. Optional detail enrichment adds benefits, industry, company website, and geo. MCP-ready so Claude and other AI agents can call it as a tool.

> **Example code (Python):** <https://github.com/johnisanerd/Apify-Wellfound-Jobs-API>

***

### 📋 What this API returns

| Field | Description |
|---|---|
| `title`, `url`, `primaryRoleTitle` | The job title, its Wellfound URL, and Wellfound's normalized role. |
| `description` | The full job description in markdown (toggle off for a lighter feed). |
| `compensationRaw` | Wellfound's raw pay string, e.g. salary plus equity. |
| `salaryMin`, `salaryMax`, `salaryCurrency` | Salary range parsed into numbers and a currency. |
| `equityMin`, `equityMax` | Equity grant range parsed into percentages. |
| `remote`, `remoteKind`, `locationNames` | Remote flag, arrangement, and location names. |
| `jobType`, `yearsExperienceMin`, `yearsExperienceMax` | Employment type and experience band. |
| `postedAt` | When the job went live, as an ISO timestamp. |
| `company` | The hiring startup: name, size, tagline, logo, and startup signals (`ycFunded`, `topInvestors`, `activelyHiring`, `stage`). |
| `benefits`, `industry`, `companyWebsite`, `geo` | Added when detail enrichment is on. |

***

### 🎯 Use cases

- **Build a startup job board.** Pull fresh startup roles into your own board, newsletter, or dataset, with full descriptions and apply links.
- **Find remote startup jobs.** Set `remoteOnly` and get every remote-friendly listing with the geographies each employer accepts.
- **Track YC startup jobs.** Filter to Y Combinator-backed companies with `ycOnly`, or to top-investor-backed and early-stage startups.
- **Search startup jobs by city.** Combine `roles` and `locations` for startup jobs in San Francisco, New York, London, or anywhere Wellfound indexes.
- **Compensation research.** Benchmark salary and equity across roles, stages, and regions using the parsed numeric fields.
- **Recruiting and sourcing.** Find companies actively hiring for a role, with company size and funding stage attached.
- **AI agent workflows.** Drive this API over MCP from Claude to pull startup jobs in-conversation.

***

### 🔌 Integrations: automate Wellfound job monitoring

A single run answers "which startups are hiring for this role today?" The real value comes from running the Wellfound Jobs API on a schedule so you accumulate a history of new postings. See the full list of [Apify platform integrations](https://docs.apify.com/platform/integrations).

**Tasks and Schedules (the core recipe).** Save one [task](https://docs.apify.com/platform/actors/running/tasks) per search you watch (a role, a city, or a YC-only filter), then attach a [schedule](https://docs.apify.com/platform/schedules) from the Actor's Actions, then Schedule menu. Useful cron strings: `0 7 * * *` (daily at 7 AM), `0 */6 * * *` (every 6 hours), `0 9 * * 1` (Mondays). One schedule can trigger many tasks at once.

**Make and Zapier.** The same pattern works no-code with [Make](https://docs.apify.com/platform/integrations/make) and [Zapier](https://docs.apify.com/platform/integrations/zapier): trigger on a schedule, run the Actor, route the new jobs to where you need them.

**Store the history (Supabase).** Send each run's rows into a table so a hiring history builds up. In Python (each row carries `id`, `title`, `company`, `salaryMin`, `salaryMax`, `remote`, `postedAt`):

```python
from apify_client import ApifyClient
from supabase import create_client

apify = ApifyClient("YOUR_APIFY_TOKEN")
supabase = create_client("YOUR_SUPABASE_URL", "YOUR_SUPABASE_KEY")

run = apify.actor("johnvc/wellfound-jobs-api").call(run_input={
    "roles": ["software-engineer"],
    "locations": ["san-francisco"],
    "maxItems": 100,
})
rows = list(apify.dataset(run.default_dataset_id).iterate_items())
supabase.table("wellfound_jobs").upsert(rows).execute()
```

**MCP and AI agents.** Add this API as a tool in Claude or Cursor through the Apify MCP server so an agent can pull startup jobs inside AI agent workflows (see the Use this API from Claude section below).

**Webhooks.** For anything custom, fire an [Apify webhook](https://docs.apify.com/platform/integrations/webhooks) on `ACTOR.RUN.SUCCEEDED` to push each run's dataset into your own service.

***

### ⚙️ Input examples

#### Jobs for a role

```json
{
  "roles": ["software-engineer"],
  "maxItems": 50
}
```

#### Role in specific cities, remote only

```json
{
  "roles": ["product-manager"],
  "locations": ["san-francisco", "new-york"],
  "remoteOnly": true,
  "maxItems": 100
}
```

#### Y Combinator startups with salary, plus detail enrichment

```json
{
  "roles": ["software-engineer"],
  "ycOnly": true,
  "minSalary": 150000,
  "fetchJobDetails": true,
  "maxItems": 50
}
```

#### Paste a Wellfound search URL directly

```json
{
  "startUrls": [{ "url": "https://wellfound.com/role/l/designer/berlin" }],
  "maxItems": 50
}
```

Provide `roles`, `locations`, a `keyword`, or `startUrls`. The API returns one row per job.

***

### Sample output

One job row (`result_type: "job"`), trimmed:

```json
{
  "result_type": "job",
  "id": "3317746",
  "title": "Software Engineer",
  "url": "https://wellfound.com/jobs/3317746-software-engineer",
  "compensationRaw": "$135k - $175k * 0.05% - 0.25%",
  "salaryMin": 135000,
  "salaryMax": 175000,
  "salaryCurrency": "USD",
  "equityMin": 0.05,
  "equityMax": 0.25,
  "remote": true,
  "locationNames": ["San Francisco"],
  "jobType": "full-time",
  "postedAt": "2026-07-28T20:58:57+00:00",
  "company": {
    "name": "Keeper",
    "slug": "keeper-tax",
    "size": "SIZE_11_50",
    "tagline": "File your complex taxes confidently",
    "ycFunded": true,
    "topInvestors": true,
    "activelyHiring": true,
    "stage": "early_stage"
  }
}
```

***

### 💰 Pricing (pay-per-event)

You are charged only for what a run actually delivers, at the smallest useful increment.

| Event | Price | When it fires |
|---|---|---|
| `job-listing` | $0.0008 | Once per job row returned (title, company, compensation, remote, dates, startup signals). |
| `job-description` | $0.0005 | Once per row that includes the full description. Turn off `includeDescription` to skip it. |
| `job-detail` | $0.003 | Once per job enriched from its detail page. Only when `fetchJobDetails` is on. |

Examples:

- 100 jobs with descriptions: 100 x ($0.0008 + $0.0005) = **$0.13**.
- 100 lightweight rows, no descriptions: 100 x $0.0008 = **$0.08**.
- 50 fully enriched jobs: 50 x ($0.0008 + $0.0005 + $0.003) = **$0.215**.

Jobs filtered out by your criteria are never charged.

***

### 🔌 Use this API from Claude (MCP)

This Actor is MCP-server-compatible, so [Claude Code](https://claude.ai/referral/uIlpa7nPLg) (free trial), Claude (desktop and web), Cursor, and other MCP clients can call it as a tool through Apify's hosted MCP server.

Add it with this Actor-specific URL:

https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api

Apify MCP integration docs: https://docs.apify.com/platform/integrations/mcp

**New to Claude Code or Claude Cowork?** Start a free trial here: https://claude.ai/referral/uIlpa7nPLg

Then ask Claude:

> *"Use the Wellfound Jobs API to find remote software-engineer jobs at Y Combinator startups paying over $150k, and list the companies."*

***

### 💸 Pay per run with crypto (x402)

The Wellfound Jobs API supports agentic payments via the [x402 protocol](https://docs.apify.com/platform/integrations/x402).
AI agents and MCP clients can pay for runs in USDC (on Base) with no Apify account or API token needed:
point your agent at the [Apify MCP server](https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api) and it can
discover, pay for, and run this Actor autonomously. Read the
[Apify x402 announcement](https://apify.com/change-log/pay-for-apify-actors-with-x402?fpr=9n7kx3) for details.

### 🚀 How to get started

1. Open the Actor and enter one or more `roles` (and optionally `locations`).
2. Add filters if you want: `remoteOnly`, `minSalary`, `ycOnly`, `fetchJobDetails`.
3. Run it and read the results from the dataset (JSON, CSV, Excel, or API).

[View on Apify Store](https://apify.com/johnvc/wellfound-jobs-api?fpr=9n7kx3)

***

### 💡 Example tasks

Ready-to-run configurations. Each opens its own setup so you can run it on your account in one click.

- [Find remote startup jobs](https://apify.com/johnvc/wellfound-jobs-api/examples/remote-startup-jobs?fpr=9n7kx3) - every remote-friendly listing, with the geographies each employer accepts.
- [Find Y Combinator startup jobs](https://apify.com/johnvc/wellfound-jobs-api/examples/yc-startup-jobs?fpr=9n7kx3) - jobs at YC-backed startups with salary, equity, and funding stage.
- [Find startup jobs in San Francisco](https://apify.com/johnvc/wellfound-jobs-api/examples/startup-jobs-san-francisco?fpr=9n7kx3) - Bay Area startup roles with company signals.
- [Find startup jobs in New York](https://apify.com/johnvc/wellfound-jobs-api/examples/startup-jobs-new-york?fpr=9n7kx3) - NYC startup roles with company signals.
- [Find startup jobs in London](https://apify.com/johnvc/wellfound-jobs-api/examples/startup-jobs-london?fpr=9n7kx3) - London startup roles with company signals.
- [Get startup salary and equity data](https://apify.com/johnvc/wellfound-jobs-api/examples/startup-salary-equity-data?fpr=9n7kx3) - salary and equity ranges parsed into numbers for analysis.

***

### 🔗 Related tools

Building a hiring or company-intelligence pipeline? These tools from the same catalog pair well with the Wellfound Jobs API:

- [LinkedIn Jobs API](https://apify.com/johnvc/linkedin-jobs-api?fpr=9n7kx3): the same structured job data from LinkedIn, to widen your sourcing beyond startups.
- [Google Jobs Scraper](https://apify.com/johnvc/Google-Jobs-Scraper?fpr=9n7kx3): aggregate postings indexed across the web by Google for Jobs.
- [Crunchbase Company API](https://apify.com/johnvc/crunchbase-company-api?fpr=9n7kx3): enrich a hiring startup with funding rounds, investors, and financials.
- [LinkedIn Company API](https://apify.com/johnvc/linkedin-company-api?fpr=9n7kx3): add headcount, industry, and LinkedIn profile data for each company.

***

### ❓ FAQ

#### Which Wellfound pages does this cover?

Public job-search pages: role pages, role-plus-location pages, remote role pages, and city pages, plus any Wellfound search URL you paste. It walks the paginated results and returns one row per job.

#### Do I get the full job description?

Yes. The full markdown description is included by default. Turn off `includeDescription` for a lighter, cheaper listing feed.

#### What are the startup signals?

Each company row carries badges Wellfound exposes: `ycFunded` (Y Combinator), `topInvestors`, `activelyHiring`, and `stage` (e.g. early stage). You can filter on them with `ycOnly`, `topInvestorsOnly`, `activelyHiringOnly`, and `companyStage`.

#### What does detail enrichment add?

With `fetchJobDetails` on, each job also gets structured salary, benefits, industry, the company's own website, applicant-location requirements, and geo coordinates, read from the job's detail page. It is billed as a separate `job-detail` event.

#### How does `keyword` work?

Wellfound has no server-side free-text search, so `keyword` filters the jobs on the pages a run fetches rather than searching the whole site. If the keyword names a job function (for example "software" or "pm") it is mapped to the matching Wellfound role page and used as the search itself. For anything else, put the job function in `roles` and use `keyword` to narrow it further.

#### What can I put in `roles`?

Wellfound role slugs, or plain words that get mapped to them: "software" becomes `software-engineer`, "pm" becomes `product-manager`, "ml" becomes `machine-learning-engineer`. Common slugs include `software-engineer`, `developer`, `engineer`, `product-manager`, `product-designer`, `designer`, `data-scientist`, `data-analyst`, `marketing`, `growth-marketer`, `sales-manager`, `devops-engineer`, `backend-engineer`, `frontend-engineer`, `machine-learning-engineer`. A slug Wellfound does not serve returns a clear error rather than an empty result.

#### Can I filter by salary or equity?

Yes. Set `minSalary`, `maxSalary`, or `minEquity`. Salary and equity are parsed from Wellfound's compensation string into numeric fields. Jobs without the relevant data are dropped when you set a minimum.

#### Can I schedule the Wellfound Jobs API?

Yes. Create a [saved task](https://docs.apify.com/platform/actors/running/tasks) with your search, then attach a [schedule](https://docs.apify.com/platform/schedules) from the Actor's Actions, then Schedule menu. Cron examples: `0 7 * * *` daily at 7 AM, `0 */6 * * *` every six hours. See the Integrations section for the full recipe.

#### Should I use an API or a web scraper for Wellfound jobs?

Both, and this Actor is both. A plain [web scraper](https://en.wikipedia.org/wiki/Web_scraping) of Wellfound returns messy HTML and breaks when the layout changes, while this Actor gives you clean, structured [API](https://en.wikipedia.org/wiki/API) output: call it yourself, pay per job, and get the same JSON whether you pull one page or many.

#### Can I use the Wellfound Jobs API programmatically?

Yes. The Apify API runs the Actor, schedules it, and fetches datasets, and the `apify-client` package exists for both Node.js and Python. See the [Apify API tab](https://apify.com/johnvc/wellfound-jobs-api/api?fpr=9n7kx3) for ready-made snippets.

#### Can I use the Wellfound Jobs API through an MCP server?

Yes. Add it as a tool in any MCP client (Claude, Cursor, and others) through the hosted [Apify MCP server](https://mcp.apify.com/) with the Actor-specific URL `https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api`. In [Claude Code](https://claude.ai/referral/uIlpa7nPLg) (free trial) or [Claude Cowork](https://claude.ai/referral/uIlpa7nPLg) (free trial) your agent can then answer questions like "which YC startups are hiring remote engineers over $150k?" inside AI agent workflows.

#### How do I find remote startup jobs with this API?

Set `remoteOnly` to true. Each row carries `remote`, `remoteKind` (for example ONSITE\_OR\_REMOTE), and `acceptedRemoteLocationNames`, so you can tell a fully remote role from a hybrid one and see which countries the employer will hire from.

#### How do I find Y Combinator startup jobs?

Set `ycOnly` to true. Every company row carries the startup signals Wellfound publishes, so you can also filter to top-investor-backed companies (`topInvestorsOnly`), a funding stage (`companyStage`), or companies with the actively-hiring badge (`activelyHiringOnly`).

#### Can I get startup jobs for a specific city?

Yes. Combine `roles` with `locations`, for example roles `software-engineer` and locations `san-francisco`, `new-york`, or `london`. Each role and location pair becomes its own search.

#### Is Wellfound free for job seekers?

Yes, Wellfound is free for candidates. This API reads the same public job pages a visitor sees, and returns them as structured data for analysis, aggregation, or an agent workflow.

#### Where do startups post jobs?

Wellfound (formerly AngelList Talent) is one of the largest startup-specific job boards, alongside company career pages and the general boards. This API covers the Wellfound side and pairs with the LinkedIn and Google Jobs APIs listed above for broader coverage.

#### What is Wellfound?

Wellfound (formerly AngelList Talent) is a marketplace connecting startups with candidates, known for showing salary and equity ranges up front. Background: [AngelList](https://en.wikipedia.org/wiki/AngelList).

***

### 🌐 About Alpha OSINT

This Actor is part of [Alpha OSINT](https://www.alphaosint.com), a toolset of financial and operations data sources and APIs.
See the [Wellfound Jobs API source page](https://www.alphaosint.com/sources/wellfound-jobs-api/) for related tools and use cases.
For support or requests for this actor, please start a ticket [directly on our support page](https://apify.com/johnvc/wellfound-jobs-api/issues/open?fpr=9n7kx3).

Last Updated: 2026.08.18

# Actor input Schema

## `roles` (type: `array`):

Role categories to search. Accepts Wellfound slugs (software-engineer, product-manager, data-scientist, designer, marketing...) or plain words that are mapped for you: 'software' becomes software-engineer, 'pm' becomes product-manager. Each role becomes its own search thread.

## `locations` (type: `array`):

Location slugs to filter by (e.g. san-francisco, new-york, london, india, remote). Each role x location pair becomes its own search thread. Leave empty for all locations.

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

Return only jobs flagged as remote.

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

Narrow the results to jobs whose title, description, company, or location contains this phrase (case-insensitive). Wellfound has no site-wide free-text search, so this filters the pages the run fetches. If you give a keyword with no roles and it names a job function, it is used as the role search itself.

## `excludeKeyword` (type: `string`):

Drop jobs whose title or description contains this phrase (case-insensitive).

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

Filter by employment type.

## `minSalary` (type: `integer`):

Drop jobs whose maximum salary is below this. 0 = no minimum. Jobs without salary data are dropped when a minimum is set.

## `maxSalary` (type: `integer`):

Drop jobs whose minimum salary exceeds this. 0 = no maximum.

## `minEquity` (type: `integer`):

Drop jobs whose maximum equity grant is below this percent. 0 = no minimum. Jobs without equity data are dropped when a minimum is set.

## `ycOnly` (type: `boolean`):

Keep only jobs at Y Combinator-funded startups (from the company's YC badge).

## `topInvestorsOnly` (type: `boolean`):

Keep only jobs at startups flagged as backed by top investors.

## `activelyHiringOnly` (type: `boolean`):

Keep only jobs at startups with the 'Actively Hiring' badge.

## `companyStage` (type: `string`):

Keep only jobs at companies at this funding stage (e.g. early\_stage, growth\_stage). Leave blank for any stage.

## `includeDescription` (type: `boolean`):

Include the full job description (markdown) in each row. Turn off for a lighter, cheaper listing feed.

## `fetchJobDetails` (type: `boolean`):

For each job, also fetch its detail page to add structured salary, benefits, industry, company website, applicant-location requirements, and geo coordinates. One extra request and one extra charge per job.

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

Maximum number of jobs to return across all search threads (after filtering).

## `maxPagesPerSearch` (type: `integer`):

Safety cap on pages fetched per search thread (each page holds ~20-50 jobs). maxItems is the primary cap.

## `startUrls` (type: `array`):

Paste Wellfound search URLs to scrape directly (e.g. https://wellfound.com/role/l/product-manager/berlin). Each URL becomes its own search thread. When set, they are used alongside any roles/locations above.

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

Wellfound can challenge automated traffic. The default network settings are tuned for reliable runs; advanced users can override them.

## Actor input object example

```json
{
  "roles": [
    "software-engineer"
  ],
  "remoteOnly": false,
  "jobType": "any",
  "minSalary": 0,
  "maxSalary": 0,
  "minEquity": 0,
  "ycOnly": false,
  "topInvestorsOnly": false,
  "activelyHiringOnly": false,
  "includeDescription": true,
  "fetchJobDetails": false,
  "maxItems": 50,
  "maxPagesPerSearch": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `allResults` (type: `string`):

Every dataset item from this run: job rows (result\_type='job') and any error rows.

## `overview` (type: `string`):

Tabular overview of every job: type, title, company, compensation, remote, locations, job type, posted date, and URL.

## `compensation` (type: `string`):

Salary and equity view: title, company, parsed salary min/max and currency, equity min/max, and URL.

# 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 = {
    "roles": [
        "software-engineer"
    ],
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("johnvc/wellfound-jobs-api").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 = {
    "roles": ["software-engineer"],
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("johnvc/wellfound-jobs-api").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 '{
  "roles": [
    "software-engineer"
  ],
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call johnvc/wellfound-jobs-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,johnvc/wellfound-jobs-api"
        }
    }
}

```

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/mR53JWL9AQavhMjpm/builds/aHBspwuWwhxbU7LeP/openapi.json