# Y Combinator Company Directory: Hiring and Team Size Filters (`transparent_meteorite/y-combinator-company-directory`) Actor

Export the Y Combinator company directory by batch, industry, region, status, hiring, team size, tags, keyword and launch date. One row per company, optional LinkedIn/X/Crunchbase links, new-only monitor. No login, no API key.

- **URL**: https://apify.com/transparent_meteorite/y-combinator-company-directory.md
- **Developed by:** [Detroit Web Agent - Open Data](https://apify.com/transparent_meteorite) (community)
- **Categories:** Lead generation, Business, Jobs
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 company profile add-ons

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Y Combinator Company Directory: Hiring and Team Size Filters

Export the Y Combinator startup directory as clean rows, one company per row, filtered the way you actually prospect: by **batch, industry, region or city, status, hiring, team size range, tags, keyword and launch date**. Turn on the optional profile add-on to get each company's **LinkedIn, X/Twitter, Facebook, Crunchbase and GitHub links, year founded, HQ city and country, open jobs count and founder count**. Schedule it with **onlyNew** and you get only the YC companies you have not received before.

No login, no cookies, no API key. You pay per company delivered, and nothing else except a tiny start fee.

### What does this actor do?

- Reads the full public YC company directory (about 6,400 launched companies, every batch from 2005 to the newest) from the **yc-oss JSON mirror**, which refreshes daily from YC's own directory.
- If the mirror is down, slow or returns an incomplete file, it **switches automatically to the public search index that ycombinator.com/companies itself uses**. Both sources return the same row shape, and the `source` field says which one served the row.
- Applies all your filters, sorts the rows, cuts at `maxItems`, and charges only for rows it delivers.
- Optional: reads each delivered company's public YC profile page for social links and profile details (separate add-on event, charged only when the page was read).

#### Why use it

| | This actor | Typical YC directory actors on the Store |
|---|---|---|
| Price per company | $0.0008 | $0.001 to $0.004, several also charge $0.005 to $0.01 per run start |
| Start fee | $0.00005 | up to $0.01 |
| Filters | batch (codes, names or years), industry, sub-industry, region or city, status, hiring, team size min/max, tags, keyword, launch date range, top companies | usually batch and a keyword or a search URL |
| Second source if the first fails | yes, automatic | usually one source |
| New-only monitor | yes (`onlyNew`) | rarely |
| Social links | optional add-on, $0.001 per company | sometimes, often at a higher combined price |

Rival prices were read from the Apify Store on 2026-11-05 and can change; check the current Store listings before you compare.

### How it works

1. Picks the smallest source file that answers your query: one small batch file per batch when you name up to 8 exact batches, otherwise the full directory file (about 2.3 MB compressed, read once).
2. Normalizes every company into the same 38-field row and drops anything that fails validation (validated rows only are pushed and charged).
3. Filters, sorts (`newest`, `oldest`, `teamSizeDesc`, `teamSizeAsc`, `name`, `batchNewest`) and stops at `maxItems` or at your maximum cost per run, whichever comes first.
4. With `includeSocials`, fetches each delivered company's public YC page at a polite rate (about 3 per second) and merges the profile fields.

### Input

| Field | Type | What it does |
|---|---|---|
| `batches` | list | `W24`, `S25`, `X25` (Spring), `F24` (Fall), `Winter 2024`, or a year like `2025` for every batch that year. Empty = all. |
| `industries` | list | YC industry or sub-industry, any of: `B2B`, `Fintech`, `Healthcare`, `Consumer`, `Industrials`, `Engineering, Product and Design`, `Infrastructure`, `Supply Chain and Logistics`, `Payments`, ... |
| `regions` | list | YC regions (`United States of America`, `Europe`, `Latin America`, `South Asia`, `Remote`, `Fully Remote`) or a place in the location (`San Francisco`, `New York`, `London`, `Germany`). |
| `statuses` | list | `Active`, `Inactive`, `Acquired`, `Public`. |
| `hiringOnly` | boolean | Only companies YC marks as hiring. |
| `minTeamSize` / `maxTeamSize` | integer | Team size range (companies with no team size are excluded when a range is set). |
| `keyword` | text | Matches name, former names, one-liner, description and tags. Comma-separate to match any of several. |
| `tags` | list | Exact YC tags, e.g. `Artificial Intelligence`, `Generative AI`, `SaaS`, `Robotics`. |
| `topCompaniesOnly` | boolean | Only YC Top Companies. |
| `launchedAfter` / `launchedBefore` | date | YYYY-MM-DD, YC directory launch date. |
| `sortBy` | select | Row order, applied before `maxItems`. Default `newest`. |
| `maxItems` | integer | Rows to deliver and charge. Default 25, up to 10,000. |
| `includeSocials` | boolean | Profile add-on (social links, year founded, city, country, open jobs, founder count). |
| `onlyNew` | boolean | Monitor mode: skip companies delivered in earlier runs. |
| `stateStoreName` | text | Named store that remembers delivered companies (one per saved filter set). |
| `source` | select | `auto` (default), `yc-oss`, or `algolia` (YC directory search index). |
| `maxRunSeconds` | integer | Soft time budget, default 600. |

#### Input example

```json
{
  "batches": ["W25", "X25", "S25"],
  "industries": ["B2B"],
  "regions": ["United States of America"],
  "statuses": ["Active"],
  "hiringOnly": true,
  "minTeamSize": 5,
  "maxTeamSize": 50,
  "keyword": "agent",
  "includeSocials": true,
  "maxItems": 100
}
```

### Output

One row per company. All fields are nullable; the add-on fields are `null` unless `includeSocials` is on and the page was read (`profileEnriched: true`).

`name`, `slug`, `oneLiner`, `longDescription`, `website`, `websiteDomain`, `batch`, `batchCode`, `status`, `industry`, `subindustry`, `industries`, `regions`, `location`, `teamSize`, `isHiring`, `launchedAt`, `stage`, `tags`, `topCompany`, `nonprofit`, `formerNames`, `logoUrl`, `ycUrl`, `ycId`, `source`, `profileEnriched`, `linkedinUrl`, `twitterUrl`, `facebookUrl`, `crunchbaseUrl`, `githubUrl`, `yearFounded`, `city`, `country`, `openJobs`, `foundersCount`, `scrapedAt`.

#### Sample output

Real rows from a test run (W24, hiring only, profile add-on on), shortened:

| name | batch | status | teamSize | isHiring | location | website | linkedinUrl | yearFounded | openJobs |
|---|---|---|---|---|---|---|---|---|---|
| FurtherAI | Winter 2024 | Active | 36 | true | San Francisco, CA, USA | https://www.furtherai.com | linkedin.com/company/furtherai | 2023 | 14 |
| Astro Mechanica | Winter 2024 | Active | 52 | true | San Francisco, CA, USA | https://astromecha.co | linkedin.com/company/astro-mechanica | 2021 | 2 |
| ProSights | Winter 2024 | Active | 14 | true | New York City, NY, USA | https://prosights.co | linkedin.com/company/prosightsdata | 2024 | 2 |

```json
{
  "name": "ProSights",
  "slug": "prosights",
  "oneLiner": "Data services for finance and operations at PE-backed companies.",
  "website": "https://prosights.co",
  "websiteDomain": "prosights.co",
  "batch": "Winter 2024",
  "batchCode": "W24",
  "status": "Active",
  "industries": ["B2B", "Finance and Accounting"],
  "location": "New York City, NY, USA",
  "teamSize": 14,
  "isHiring": true,
  "launchedAt": "2024-03-25",
  "ycUrl": "https://www.ycombinator.com/companies/prosights",
  "source": "yc-oss",
  "profileEnriched": true,
  "linkedinUrl": "https://www.linkedin.com/company/prosightsdata/",
  "crunchbaseUrl": "https://www.crunchbase.com/organization/prosights",
  "yearFounded": 2024,
  "openJobs": 2,
  "foundersCount": 2
}
```

Two dataset views are included: **Companies** (overview table) and **Social links (add-on)**. Export as JSON, CSV, Excel or through the API.

### Pricing

Pay per event. You are charged only for rows delivered to your dataset.

| Event | Price | When |
|---|---|---|
| Actor start | $0.00005 | Once per run |
| Company returned | $0.0008 | Per company row delivered |
| Company profile add-on | $0.001 | Per company whose YC profile page was read, only with `includeSocials` |

#### Worked cost examples

- 100 hiring B2B companies from the 2025 batches: $0.00005 + 100 x $0.0008 = **$0.08**.
- The same 100 with social links: $0.00005 + 100 x ($0.0008 + $0.001) = **$0.18**.
- The whole directory (about 6,400 companies): about **$5.12** without the add-on.
- A daily `onlyNew` monitor that finds 3 new matching companies: about **$0.0025** per day.

Set **Maximum cost per run** in the run options to cap any run; the actor stops cleanly before it would go over and keeps every row already delivered.

### Use cases

- **Sales prospecting:** pull every Active, hiring YC company with 10 to 100 people in your target industry and region, with website domain and LinkedIn, and push it to your CRM.
- **Recruiting and job hunting:** list the hiring companies in the newest batches, sorted by newest launch, with open job counts.
- **Investors and analysts:** export a batch or a sector (for example every Fintech company from 2020 to 2025) with status, team size and launch dates to study outcomes such as Acquired or Public.
- **New-company alerts:** schedule `onlyNew` daily with your filters and send each new YC company to Slack, email or a sheet through an integration or n8n / Make / Zapier.
- **Enrichment pipelines:** use `websiteDomain` to join with tech stack, contact or funding data.

#### Related actors

- [Company Enrichment by Domain](https://apify.com/transparent_meteorite/company-enrichment-by-domain): enrich the `websiteDomain` column.
- [ATS Open Roles](https://apify.com/transparent_meteorite/ats-open-roles): the actual open roles from the company's applicant tracking system.
- [Hiring Velocity Signals](https://apify.com/transparent_meteorite/hiring-velocity-signals): which companies are hiring faster.
- [SEC Form D Funding Leads](https://apify.com/transparent_meteorite/sec-form-d-funding-leads): companies that just filed a private funding round.

### Use with the API, n8n, Make, Zapier or AI agents

**API** (one call, returns the rows as JSON):

```bash
curl -X POST "https://api.apify.com/v2/acts/transparent_meteorite~y-combinator-company-directory/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"batches":["W25","X25","S25"],"hiringOnly":true,"statuses":["Active"],"maxItems":25}'
```

The call waits up to 5 minutes. For bigger inputs, start the run with `/runs` instead and read the dataset when it finishes.

**Python**

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("transparent_meteorite/y-combinator-company-directory").call(run_input={"batches": ["W25", "X25", "S25"], "hiringOnly": True, "statuses": ["Active"], "maxItems": 25})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row)
```

- **n8n, Make, Zapier:** use the Apify app's "Run Actor" step with actor `transparent_meteorite/y-combinator-company-directory`, paste the input JSON, then map the dataset items to your sheet or CRM.
- **Clay:** add an HTTP API column that calls the run-sync endpoint above.
- **Schedules:** in Apify Console, Schedules, run it daily or weekly with the same input for a steady feed.
- **AI agents (MCP):** connect the Apify MCP server at `https://mcp.apify.com?tools=transparent_meteorite/y-combinator-company-directory` to Claude, Cursor or any MCP client, and your agent can run Y Combinator Company Directory on request.

### FAQ

**Where does the data come from?**
From the public YC company directory: the yc-oss JSON mirror (an open-source project that republishes the directory daily) and, as fallback, the public search index used by ycombinator.com/companies. The add-on reads the public company page on ycombinator.com.

**How fresh is it?**
The mirror is rebuilt daily; the fallback index is live. A company added to YC's directory today normally appears within a day.

**Does it return founder names or emails?**
No. This actor outputs company-level data only. The add-on counts founders (`foundersCount`) but does not output their names, emails or personal profiles.

**Why is a company's team size or website empty?**
YC leaves some fields blank for some companies (about 2% have no team size, about 5% no website). Empty fields are `null`, never made up.

**What do X25 and F24 mean?**
YC added Spring (X) and Fall (F) batches in 2024 and 2025. `X25` is Spring 2025 and `F24` is Fall 2024; `W` is Winter, `S` is Summer.

**How does onlyNew work?**
Each delivered company's slug is stored in a named key-value store in your account. Later runs with the same store name skip those companies and do not charge for them. Use a different `stateStoreName` for each saved filter set.

**What happens if a source is down?**
With `source: auto`, a failed or incomplete mirror switches to the YC search index automatically. If both are down the run ends successfully with a clear message, an empty dataset, and nothing charged except the start event.

### Limitations

- Only companies that YC lists publicly on its directory are included; some companies hide their listing.
- Team size, hiring status and descriptions are what the company or YC entered; they can be out of date.
- The fallback search index reads at most 1,000 companies per batch per query (no YC batch is that large today; the run notes if it ever happens).
- The profile add-on runs at about 3 companies per second to stay polite to ycombinator.com, so 1,000 enriched companies take about 6 minutes.
- Social links are only those the company added to its YC profile; many early companies leave them blank.
- This is not an official Y Combinator product and is not affiliated with or endorsed by Y Combinator.

# Actor input Schema

## `batches` (type: `array`):

YC batches to include. Accepts W24, S25, X25 (Spring), F24 (Fall), "Winter 2024", or a year such as 2025 for every batch that year. Empty = all batches.

## `industries` (type: `array`):

Match YC industry or sub-industry names, case-insensitive, any of: e.g. B2B, Fintech, Healthcare, Consumer, Industrials, Education, Government, "Real Estate and Construction", "Engineering, Product and Design", "Infrastructure", "Supply Chain and Logistics". Empty = all.

## `regions` (type: `array`):

Match YC regions (e.g. "United States of America", Europe, "Latin America", "South Asia", India, Canada, Remote, "Fully Remote") or a place in the company location (e.g. "San Francisco", "New York", London, Germany). Any of. Empty = all.

## `statuses` (type: `array`):

Company status on the YC directory. Empty = all.

## `hiringOnly` (type: `boolean`):

Only companies that YC shows as currently hiring.

## `minTeamSize` (type: `integer`):

Only companies with at least this many people (companies with no team size are excluded when a range is set).

## `maxTeamSize` (type: `integer`):

Only companies with at most this many people.

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

Case-insensitive match in name, former names, one-liner, long description and tags. Comma-separate several keywords to match any of them, e.g. "voice agent, speech".

## `tags` (type: `array`):

Exact YC tags, any of, e.g. "Artificial Intelligence", "Generative AI", "SaaS", "Robotics", "Developer Tools", "Climate".

## `topCompaniesOnly` (type: `boolean`):

Only companies on the YC Top Companies list.

## `launchedAfter` (type: `string`):

YYYY-MM-DD. Uses the YC directory launch date.

## `launchedBefore` (type: `string`):

Date as YYYY-MM-DD, e.g. 2023-12-31. Uses the YC directory launch date; leave empty for no upper limit.

## `sortBy` (type: `string`):

Order of the rows (applied before maxItems).

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

Maximum number of company rows to deliver (and charge). The full directory is about 6,400 companies.

## `includeSocials` (type: `boolean`):

Reads each delivered company's public YC profile page and adds LinkedIn, X/Twitter, Facebook, Crunchbase and GitHub links, year founded, city, country, open jobs count and founder count. Charged as a separate per-company event, only when the page was read. Slower (about 3 companies per second).

## `onlyNew` (type: `boolean`):

Skip companies this monitor already delivered in earlier runs (kept in a named key-value store). Schedule it daily to get only newly listed YC companies that match your filters.

## `stateStoreName` (type: `string`):

Named key-value store that remembers delivered companies for onlyNew. Use a different name per saved filter set.

## `source` (type: `string`):

auto = yc-oss JSON mirror first, YC directory search index if the mirror fails. Force one source if you prefer.

## `maxRunSeconds` (type: `integer`):

Soft time budget; the run stops cleanly before it and keeps delivered rows.

## Actor input object example

```json
{
  "batches": [
    "W25",
    "X25",
    "S25"
  ],
  "statuses": [],
  "hiringOnly": false,
  "topCompaniesOnly": false,
  "sortBy": "newest",
  "maxItems": 25,
  "includeSocials": false,
  "onlyNew": false,
  "stateStoreName": "y-combinator-company-directory-seen",
  "source": "auto",
  "maxRunSeconds": 600
}
```

# Actor output Schema

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

No description

## `socials` (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 = {
    "batches": [
        "W25",
        "X25",
        "S25"
    ],
    "maxItems": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("transparent_meteorite/y-combinator-company-directory").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 = {
    "batches": [
        "W25",
        "X25",
        "S25",
    ],
    "maxItems": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("transparent_meteorite/y-combinator-company-directory").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 '{
  "batches": [
    "W25",
    "X25",
    "S25"
  ],
  "maxItems": 25
}' |
apify call transparent_meteorite/y-combinator-company-directory --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,transparent_meteorite/y-combinator-company-directory"
        }
    }
}
```

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/rdFHeJsrvQraYLaHf/builds/yn8TYzWi9eWvGBGHS/openapi.json
