# Y Combinator Scraper — Companies, Founders & Jobs (`scrapesage/ycombinator-scraper`) Actor

Scrape the full Y Combinator startup directory: company profile, batch, status, team size, industry, location, website, plus founders with LinkedIn/Twitter, company socials and open jobs. Filter by batch, industry, region or status. Monitor mode for new companies. No login.

- **URL**: https://apify.com/scrapesage/ycombinator-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Lead generation, Jobs, Developer tools
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 company scrapeds

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## Y Combinator Scraper — Companies, Founders, Socials & Jobs

Extract the **entire Y Combinator startup directory** — every company across every batch (W05 → the latest cohort) with the full profile **plus the data other YC scrapers skip**: **founders with their LinkedIn & Twitter/X**, **company social links** (LinkedIn, X, Facebook, GitHub, Crunchbase), the **YC group partner**, and **open job postings** with salary & equity ranges. Turn ~6,000 funded startups into a ready-to-use **B2B lead list, sourcing pipeline, or startup-intelligence dataset**.

No login, no cookies, no browser — it reads YC's own public Algolia directory and profile pages directly, with a built-in **monitor mode** that surfaces only new companies, batches, and jobs.

### Why this Y Combinator scraper?

Most YC scrapers dump the directory's basic columns and stop. This actor merges YC's public **Algolia index** (complete, fast, filterable) with each company's **profile page** to ship the **richest YC dataset available** — including founder contacts and company socials that make every row an actual lead.

| Data | Typical YC scrapers | This actor |
|---|---|---|
| Company name, batch, status, team size, industry, location | ✅ | ✅ |
| One-liner + full long description | partial | ✅ |
| Tags, sub-industry, region, stage, top-company flag | partial | ✅ |
| Company website | ✅ | ✅ |
| **Founders** (name, title, bio) | ❌ | ✅ |
| **Founder LinkedIn & Twitter/X** | ❌ | ✅ |
| Company **LinkedIn / X / Facebook / GitHub / Crunchbase** | ❌ | ✅ |
| YC group partner, year founded, city/country | ❌ | ✅ |
| **Open jobs** (title, role, location, salary & equity) | ❌ | ✅ opt-in |
| Full directory past Algolia's 1,000-result cap | partial | ✅ (batch-sliced) |
| Monitor mode — only new companies / jobs | ❌ | ✅ |

### Use cases

- **B2B lead generation** — every YC company is a funded, fast-moving buyer. Export them with website, founders, and founder LinkedIn/Twitter to feed your CRM or outreach.
- **Sourcing & recruiting** — find founders and engineers by batch, industry, or tag; pull open roles with comp ranges straight from the directory.
- **VC / competitive & market intelligence** — track every batch, watch which industries and tags are growing, and monitor competitors and portfolio companies.
- **Sales prospecting to startups** — filter by batch, region, stage, and "is hiring" to build targeted lists of companies likely to buy dev tools, infra, fintech, and services.
- **Datasets & dashboards** — build and maintain a clean YC startup database for analytics and research.

### How to use

1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **Y Combinator Scraper**, set filters (batch, industry, region, status…) or paste a YC directory URL, and click **Start**.
3. Watch companies — with founders and socials — stream into the dataset.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results via the [Apify API](https://docs.apify.com/api/v2).

### Input

```json
{
    "batches": ["Summer 2024", "Winter 2025"],
    "industries": ["B2B", "Fintech"],
    "isHiring": true,
    "enrichProfile": true,
    "includeJobs": true,
    "maxItems": 500,
    "onlyNewItems": false
}
````

- **batches / industries / subindustries / regions / tags / statuses / stages** — directory filters (leave empty to sweep everything).
- **query** — optional free-text search.
- **startUrls** — paste a YC directory search URL (its filters are read automatically) or specific `…/companies/{slug}` profile URLs.
- **isHiring / topCompaniesOnly / nonprofit** — quick boolean filters.
- **enrichProfile** *(default true)* — open each company's profile for founders, socials, partner, year founded, media. Turn off for a fast directory-only pull.
- **includeJobs** *(default false)* — also output each company's open jobs as separate `job` records.
- **maxItems** — cap the number of companies (0 = the full ~6,000).
- **onlyNewItems** *(monitor mode)* — emit only companies/jobs not seen in previous runs.

### Output

One record per company (`type: "company"`), plus optional `job` records. Use the **Companies / Jobs** dataset views to switch columns.

```json
{
    "type": "company",
    "id": "271",
    "name": "Airbnb",
    "slug": "airbnb",
    "ycUrl": "https://www.ycombinator.com/companies/airbnb",
    "website": "http://airbnb.com",
    "oneLiner": "Book accommodations around the world.",
    "batchName": "Winter 2009",
    "batchSeason": "Winter",
    "batchYear": 2009,
    "batchCode": "W09",
    "status": "Public",
    "stage": "Growth",
    "teamSize": 6132,
    "industry": "Consumer",
    "subindustry": "Consumer -> Travel, Leisure and Tourism",
    "tags": ["Marketplace", "Travel"],
    "regions": ["United States of America"],
    "location": "San Francisco, CA, USA",
    "topCompany": true,
    "isHiring": false,
    "yearFounded": 2008,
    "linkedinUrl": "https://www.linkedin.com/company/airbnb",
    "twitterUrl": "https://twitter.com/airbnb",
    "githubUrl": null,
    "crunchbaseUrl": "https://www.crunchbase.com/organization/airbnb",
    "ycPartner": "...",
    "founders": [
        { "name": "Brian Chesky", "title": "Founder/CEO", "linkedin": "https://www.linkedin.com/in/brianchesky/", "twitter": "https://twitter.com/bchesky" }
    ],
    "foundersCount": 3,
    "scrapedAt": "2026-06-14T12:00:00.000Z"
}
```

A **job** record (`type: "job"`) carries `companyName`, `companySlug`, `batchName`, `jobTitle`, `role`, `location`, `remote`, `minSalary`/`maxSalary`, `minEquity`/`maxEquity`, `experience` and `applyUrl`.

#### What to expect (field coverage)

YC data is founder-entered, so some fields appear only when the company filled them in. Across the directory you can typically expect: company core fields (name, batch, status, team size, industry, website) ~100%; one-liner ~99%; founders ~95% (with `enrichProfile`); founder LinkedIn ~80% and Twitter/X ~45% (where founders listed them); company socials and jobs when published. A blank field means it wasn't published — not that scraping failed.

### Automate & schedule

- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** & **[Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly with **monitor mode** to get every new YC company, batch, and job automatically — perfect for sourcing and sales alerts.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — push new companies/leads to your CRM, Slack, or sheet the moment a run finishes.

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/ycombinator-scraper').call({
    batches: ['Summer 2024'],
    isHiring: true,
    enrichProfile: true,
    includeJobs: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} YC companies & jobs`);
```

### Integrate with any app

Connect the dataset to 5,000+ apps — no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new YC leads straight into your CRM.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get alerted when a new batch or company appears.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.

### Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "list the Summer 2024 YC fintech companies that are hiring, with founder LinkedIns" and let it run the scraper.

### More scrapers from scrapesage

Build a complete **startup & B2B intelligence / lead-gen stack**:

- **[Product Hunt Scraper](https://apify.com/scrapesage/product-hunt-scraper)** — launches, makers & leads (the perfect companion to YC).
- **[Multi-ATS Job Scraper](https://apify.com/scrapesage/multi-ats-job-scraper)** — jobs from Greenhouse, Lever, Ashby & Workday (the ATSs YC startups use).
- **[LinkedIn Jobs Scraper](https://apify.com/scrapesage/linkedin-jobs-scraper)** — filter-based job postings, no login.
- **[LinkedIn Ad Library Scraper](https://apify.com/scrapesage/linkedin-ad-library-scraper)** — competitor B2B ads & creatives.
- **[Google Ads Transparency Scraper](https://apify.com/scrapesage/google-ads-transparency-scraper)** — who's advertising what on Google.
- **[Facebook Ad Library Scraper](https://apify.com/scrapesage/facebook-ad-library-scraper)** — competitor ad intelligence on Meta & Instagram.
- **[Yellow Pages Scraper](https://apify.com/scrapesage/yellow-pages-scraper)** — local business leads with emails.
- **[Singapore Company Scraper](https://apify.com/scrapesage/singapore-company-scraper)** — UEN, registry & business leads.

### Tips

- **Full directory**: leave filters empty and `maxItems: 0` — the actor sweeps batch-by-batch to pull all ~6,000 companies past Algolia's 1,000-result cap.
- **Founders & contacts**: keep `enrichProfile` on — it's the difference between a company name and a contactable founder lead.
- **Incremental sourcing**: turn on `onlyNewItems` + an Apify [Schedule](https://docs.apify.com/platform/schedules) to capture each new YC company/batch/job as it lands.
- **Paste-a-URL**: copy any filtered URL from the YC companies page and drop it into `startUrls` — the filters carry over.

### FAQ

**How do I scrape a specific batch or industry?** Use the `batches` / `industries` filters (full names as shown on YC, e.g. `Summer 2024`, `Fintech`), or paste a filtered YC directory URL into `startUrls`.

**Does it need a login or API key?** No. It reads YC's public Algolia directory and public profile pages — no key or login.

**Can I get all ~6,000 companies?** Yes. The actor slices the directory by batch so it retrieves the entire index, not just the first 1,000 results.

**Where do founder LinkedIn/Twitter links come from?** From each company's public YC profile, where founders list them. Coverage is high for LinkedIn, lower for Twitter/X — when a founder didn't list one, the field is simply absent.

**How do I get alerted to new YC companies or jobs?** Turn on `onlyNewItems` and create an Apify [Schedule](https://docs.apify.com/platform/schedules); each run emits only what's new. Add a [webhook](https://docs.apify.com/platform/integrations/webhooks) or [Zapier zap](https://docs.apify.com/platform/integrations/zapier) to push them onward.

**Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).

**Is scraping Y Combinator legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (e.g. GDPR/CCPA for personal data) and YC's terms.

### Need help?

Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained.

# Actor input Schema

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

Optional. Paste a YC directory search URL (filters are read straight from it), e.g. <code>https://www.ycombinator.com/companies?batch=Summer%202024\&industry=Fintech</code>, or specific company profile URLs like <code>https://www.ycombinator.com/companies/airbnb</code>. Leave empty to use the filters below.

## `query` (type: `string`):

Optional free-text search across the YC directory (company name, description, tags).

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

Filter by YC batch, full names as shown on YC, e.g. <code>Summer 2024</code>, <code>Winter 2025</code>, <code>Spring 2025</code>. Leave empty to sweep all batches.

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

Filter by top-level industry, e.g. <code>B2B</code>, <code>Fintech</code>, <code>Consumer</code>, <code>Healthcare</code>, <code>Real Estate and Construction</code>, <code>Education</code>, <code>Government</code>, <code>Industrials</code>.

## `subindustries` (type: `array`):

Filter by sub-industry, e.g. <code>Fintech -> Banking and Exchange</code>, <code>B2B -> Engineering, Product and Design</code>.

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

Filter by region, e.g. <code>United States of America</code>, <code>Europe</code>, <code>India</code>, <code>Latin America</code>, <code>Remote</code>.

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

Filter by company tag, e.g. <code>Artificial Intelligence</code>, <code>SaaS</code>, <code>Developer Tools</code>, <code>Marketplace</code>, <code>Machine Learning</code>.

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

Filter by company status.

## `stages` (type: `array`):

Filter by growth stage, e.g. <code>Early</code>, <code>Growth</code>.

## `isHiring` (type: `boolean`):

Only include companies with open roles.

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

Only include companies on YC's Top Companies list.

## `nonprofit` (type: `boolean`):

Only include YC nonprofit organizations.

## `enrichProfile` (type: `boolean`):

Open each company's YC profile to also capture founders (name, title, bio, LinkedIn, Twitter/X), company social links (LinkedIn, X, Facebook, GitHub, Crunchbase), YC group partner, year founded, city/country and media. Adds one fast request per company. Turn off for a quick directory-only pull.

## `includeJobs` (type: `boolean`):

Also output each company's open job postings (title, role, location, salary & equity ranges, apply URL) as separate `job` records.

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

Maximum number of companies to scrape (0 = no limit; the full directory is ~6,000).

## `onlyNewItems` (type: `boolean`):

Remember companies (and jobs) seen in previous runs in a named key-value store and emit only new ones. Pair with an Apify Schedule to get alerted to each new YC company, batch or job — the Schedule decides WHEN to run, monitor mode decides WHICH items are new. They do not conflict.

## `monitorStoreName` (type: `string`):

Optional name of the key-value store used by monitor mode. Defaults to <code>ycombinator-monitor-state</code>.

## `maxConcurrency` (type: `integer`):

Maximum profile pages fetched in parallel.

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

Proxy settings. YC and its Algolia directory are lightly protected, so the default Apify proxy is plenty.

## `debugDump` (type: `boolean`):

Developer aid — saves the first profile page's raw HTML to the key-value store. Leave off for normal runs.

## Actor input object example

```json
{
  "isHiring": false,
  "topCompaniesOnly": false,
  "nonprofit": false,
  "enrichProfile": true,
  "includeJobs": false,
  "maxItems": 0,
  "onlyNewItems": false,
  "maxConcurrency": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "debugDump": false
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped records in the default dataset.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/ycombinator-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/ycombinator-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call scrapesage/ycombinator-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapesage/ycombinator-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Y Combinator Scraper — Companies, Founders & Jobs",
        "description": "Scrape the full Y Combinator startup directory: company profile, batch, status, team size, industry, location, website, plus founders with LinkedIn/Twitter, company socials and open jobs. Filter by batch, industry, region or status. Monitor mode for new companies. No login.",
        "version": "0.1",
        "x-build-id": "VvTM4X9WbjGnguv0D"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapesage~ycombinator-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapesage-ycombinator-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scrapesage~ycombinator-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapesage-ycombinator-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scrapesage~ycombinator-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapesage-ycombinator-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "startUrls": {
                        "title": "YC URLs (search or profile)",
                        "type": "array",
                        "description": "Optional. Paste a YC directory search URL (filters are read straight from it), e.g. <code>https://www.ycombinator.com/companies?batch=Summer%202024&industry=Fintech</code>, or specific company profile URLs like <code>https://www.ycombinator.com/companies/airbnb</code>. Leave empty to use the filters below.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "query": {
                        "title": "Search query",
                        "type": "string",
                        "description": "Optional free-text search across the YC directory (company name, description, tags)."
                    },
                    "batches": {
                        "title": "Batches",
                        "type": "array",
                        "description": "Filter by YC batch, full names as shown on YC, e.g. <code>Summer 2024</code>, <code>Winter 2025</code>, <code>Spring 2025</code>. Leave empty to sweep all batches.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "industries": {
                        "title": "Industries",
                        "type": "array",
                        "description": "Filter by top-level industry, e.g. <code>B2B</code>, <code>Fintech</code>, <code>Consumer</code>, <code>Healthcare</code>, <code>Real Estate and Construction</code>, <code>Education</code>, <code>Government</code>, <code>Industrials</code>.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "subindustries": {
                        "title": "Sub-industries",
                        "type": "array",
                        "description": "Filter by sub-industry, e.g. <code>Fintech -> Banking and Exchange</code>, <code>B2B -> Engineering, Product and Design</code>.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "regions": {
                        "title": "Regions",
                        "type": "array",
                        "description": "Filter by region, e.g. <code>United States of America</code>, <code>Europe</code>, <code>India</code>, <code>Latin America</code>, <code>Remote</code>.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "tags": {
                        "title": "Tags",
                        "type": "array",
                        "description": "Filter by company tag, e.g. <code>Artificial Intelligence</code>, <code>SaaS</code>, <code>Developer Tools</code>, <code>Marketplace</code>, <code>Machine Learning</code>.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "statuses": {
                        "title": "Status",
                        "type": "array",
                        "description": "Filter by company status.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Active",
                                "Acquired",
                                "Public",
                                "Inactive"
                            ]
                        }
                    },
                    "stages": {
                        "title": "Stage",
                        "type": "array",
                        "description": "Filter by growth stage, e.g. <code>Early</code>, <code>Growth</code>.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "isHiring": {
                        "title": "Only companies hiring",
                        "type": "boolean",
                        "description": "Only include companies with open roles.",
                        "default": false
                    },
                    "topCompaniesOnly": {
                        "title": "Only YC Top Companies",
                        "type": "boolean",
                        "description": "Only include companies on YC's Top Companies list.",
                        "default": false
                    },
                    "nonprofit": {
                        "title": "Only nonprofits",
                        "type": "boolean",
                        "description": "Only include YC nonprofit organizations.",
                        "default": false
                    },
                    "enrichProfile": {
                        "title": "Enrich with founders & socials",
                        "type": "boolean",
                        "description": "Open each company's YC profile to also capture founders (name, title, bio, LinkedIn, Twitter/X), company social links (LinkedIn, X, Facebook, GitHub, Crunchbase), YC group partner, year founded, city/country and media. Adds one fast request per company. Turn off for a quick directory-only pull.",
                        "default": true
                    },
                    "includeJobs": {
                        "title": "Scrape open jobs",
                        "type": "boolean",
                        "description": "Also output each company's open job postings (title, role, location, salary & equity ranges, apply URL) as separate `job` records.",
                        "default": false
                    },
                    "maxItems": {
                        "title": "Max companies",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of companies to scrape (0 = no limit; the full directory is ~6,000).",
                        "default": 0
                    },
                    "onlyNewItems": {
                        "title": "Monitor mode — only new items",
                        "type": "boolean",
                        "description": "Remember companies (and jobs) seen in previous runs in a named key-value store and emit only new ones. Pair with an Apify Schedule to get alerted to each new YC company, batch or job — the Schedule decides WHEN to run, monitor mode decides WHICH items are new. They do not conflict.",
                        "default": false
                    },
                    "monitorStoreName": {
                        "title": "Monitor store name",
                        "type": "string",
                        "description": "Optional name of the key-value store used by monitor mode. Defaults to <code>ycombinator-monitor-state</code>."
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "Maximum profile pages fetched in parallel.",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings. YC and its Algolia directory are lightly protected, so the default Apify proxy is plenty.",
                        "default": {
                            "useApifyProxy": true
                        }
                    },
                    "debugDump": {
                        "title": "Debug: dump raw HTML",
                        "type": "boolean",
                        "description": "Developer aid — saves the first profile page's raw HTML to the key-value store. Leave off for normal runs.",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```