# YC Companies & Founders Scraper (`rl1987/ycombinator-scraper`) Actor

Scrape the Y Combinator Companies and Founders directories via their public Algolia search API.

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

## Pricing

from $1.00 / 1,000 result items

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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.

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

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

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

Extract structured data from the official [Y Combinator startup directory](https://www.ycombinator.com/companies) and [YC founders directory](https://www.ycombinator.com/founders) - no browser rendering required. This Actor talks directly to the same Algolia search API that powers both directory pages, so it's fast, reliable, and returns every field the website itself uses (name, description, batch, industry, location, team size, founder titles, and more). Run it on the Apify platform to get scheduled runs, API access, webhooks, and proxy support out of the box.

### Why use YC Companies & Founders Scraper?

- **Lead generation & investor research** - build a list of startups by batch, industry, or region to find investment targets or partnership leads.
- **Recruiting & sales prospecting** - pull founder names, titles, and current companies to build outreach lists.
- **Market research** - analyze YC's startup portfolio by industry, stage, or funding batch over time.
- **Competitive intelligence** - track which companies are hiring, which have shut down, and how industries trend across batches.

### How to use YC Companies & Founders Scraper

1. Click **Try for free**.
2. On the **Input** tab, choose a **Mode**: `companies` or `founders`.
3. Optionally set a **Search query** (same as the search box on the directory page), a **Max items** limit, and pick from any of the narrowing dropdowns (Batch, Region, Industry, Tags, Status, Is Hiring, Role) - each is populated with the same real options shown in the filter panel on the site, so there's nothing to type.
4. Click **Start** and wait for the run to finish.
5. Open the **Dataset** tab to browse, export (JSON, CSV, Excel, HTML, and more), or download your results via the API.

### Input

| Field | Type | Description |
| --- | --- | --- |
| `mode` | String | `companies` to scrape ycombinator.com/companies, or `founders` to scrape ycombinator.com/founders. |
| `query` | String | Free-text search query. Leave empty to fetch the whole directory. |
| `maxItems` | Integer | Maximum number of records to scrape. `0` = no limit. |
| `companyBatch` | Array (dropdown) | Companies only - narrow by YC batch (e.g. `Summer 2024`). |
| `founderBatch` | Array (dropdown) | Founders only - narrow by YC batch, short code (e.g. `S24`). |
| `companyRegions` | Array (dropdown) | Companies only - narrow by region/location (e.g. `United States of America`). |
| `founderRegions` | Array (dropdown) | Founders only - narrow by current region/location. |
| `industries` | Array (dropdown) | Companies only - narrow by industry (e.g. `Fintech`). |
| `tags` | Array (dropdown) | Companies only - narrow by tag (e.g. `B2B`, `AI`). |
| `status` | Array (dropdown) | Companies only - narrow by status: `Active`, `Acquired`, `Public`, or `Inactive`. |
| `isHiring` | Boolean | Companies only - only return companies that are currently hiring. |
| `ycTitles` | Array (dropdown) | Founders only - narrow by role (e.g. `Founder`, `CEO`, `CTO`). Lists the most common roles. |

All dropdown filters are populated with the actual values from the live directory (fetched at schema-build time), so you pick from a list instead of typing free text.

See the **Input** tab for the full schema and examples.

### Output

Example item in **companies** mode:

```json
{
  "id": 531,
  "name": "DoorDash",
  "slug": "doordash",
  "url": "https://www.ycombinator.com/companies/doordash",
  "website": "http://doordash.com",
  "one_liner": "Restaurant delivery.",
  "batch": "Summer 2013",
  "status": "Public",
  "team_size": 8600,
  "industry": "Consumer",
  "industries": ["Consumer", "Food and Beverage"],
  "tags": ["Marketplace", "E-commerce"],
  "all_locations": "San Francisco, CA, USA",
  "is_hiring": true
}
````

Example item in **founders** mode:

```json
{
  "id": 14644,
  "full_name": "Tony Xu",
  "url": "https://www.ycombinator.com/founders/tony-xu",
  "current_company": "DoorDash",
  "current_title": "CEO",
  "yc_titles": ["CEO"],
  "batches": ["S13"],
  "current_region": "United States of America"
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

### Data table

#### Companies

| Field | Description |
| --- | --- |
| `name`, `slug`, `url` | Company name and links to its YC profile page |
| `website` | Company's own website |
| `one_liner`, `long_description` | Short and full descriptions |
| `batch`, `status`, `stage` | YC batch, current company status (Active/Acquired/Public/Inactive), and growth stage |
| `team_size` | Reported employee count |
| `industry`, `subindustry`, `industries`, `tags` | Industry classification and tags |
| `all_locations`, `regions` | Headquarters location(s) |
| `is_hiring`, `top_company`, `nonprofit` | Flags |

#### Founders

| Field | Description |
| --- | --- |
| `full_name`, `first_name`, `last_name`, `url`, `hnid` | Identity and profile link |
| `current_company`, `current_title`, `company_slug`, `all_companies_text` | Current role |
| `yc_titles`, `batches` | Titles and YC batches across their companies |
| `yc_industries`, `yc_parent_industries`, `yc_subindustries` | Industry classification |
| `current_region` | Current location |

### How much does it cost to scrape the YC directory?

This Actor makes lightweight API calls (no browser, no proxies needed), so scraping the full directory (~6,000 companies or ~13,000 founders) typically takes under a minute and only costs a few compute units - fitting comfortably within the Apify free tier for most use cases.

### Tips

- Leave `maxItems` at `0` to get the complete directory; set it lower for quick tests.
- Use the Batch/Region/Industry/Tags/Status/Role filters to scope a run instead of scraping everything and filtering afterwards.
- Schedule runs (e.g. weekly) via Apify's built-in Scheduler to track new YC batches and founder updates over time.

### FAQ, disclaimers, and support

This Actor only reads publicly available data exposed by YC's own directory search API and does not access any authenticated Bookface content. It is provided for research and lead-generation purposes; please review [Y Combinator's Terms of Use](https://www.ycombinator.com/legal/terms) before using the data. YC may change its underlying API at any time without notice, which could require an update to this Actor. If you hit an issue or need custom fields, open a ticket on the **Issues** tab.

# Actor input Schema

## `mode` (type: `string`):

Scrape the YC Companies directory (ycombinator.com/companies) or the YC Founders directory (ycombinator.com/founders).

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

Free-text search, same as typing into the search box on the directory page. Leave empty to fetch every record.

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

Maximum number of records to scrape. Set to 0 to scrape the entire directory.

## `companyBatch` (type: `array`):

Narrow down by YC batch, same as the Batch filter on the companies page. Ignored in founders mode.

## `founderBatch` (type: `array`):

Narrow down by YC batch, same as the Batch filter on the founders page. Ignored in companies mode.

## `companyRegions` (type: `array`):

Narrow down by region, same as the Region filter on the companies page. Ignored in founders mode.

## `founderRegions` (type: `array`):

Narrow down by region, same as the Region filter on the founders page. Ignored in companies mode.

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

Narrow down by industry, same as the Industry filter on the companies page. Ignored in founders mode.

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

Narrow down by tag, same as the Tags filter on the companies page. Ignored in founders mode.

## `status` (type: `array`):

Narrow down by company status, same as the Status filter on the companies page. Ignored in founders mode.

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

Same as the "Is Hiring" filter on the companies page. Ignored in founders mode.

## `ycTitles` (type: `array`):

Narrow down by role, same as the Role filter on the founders page. Shows the most common roles; ignored in companies mode.

## Actor input object example

```json
{
  "mode": "companies",
  "query": "",
  "maxItems": 0,
  "companyBatch": [],
  "founderBatch": [],
  "companyRegions": [],
  "founderRegions": [],
  "industries": [],
  "tags": [],
  "status": [],
  "isHiring": false,
  "ycTitles": []
}
```

# Actor output Schema

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

YC company or founder records (depending on the selected mode).

# 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("rl1987/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("rl1987/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 rl1987/ycombinator-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "YC Companies & Founders Scraper",
        "description": "Scrape the Y Combinator Companies and Founders directories via their public Algolia search API.",
        "version": "0.1",
        "x-build-id": "AL28cXBkcGd9hwvaI"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/rl1987~ycombinator-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-rl1987-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/rl1987~ycombinator-scraper/runs": {
            "post": {
                "operationId": "runs-sync-rl1987-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/rl1987~ycombinator-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-rl1987-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",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "companies",
                            "founders"
                        ],
                        "type": "string",
                        "description": "Scrape the YC Companies directory (ycombinator.com/companies) or the YC Founders directory (ycombinator.com/founders).",
                        "default": "companies"
                    },
                    "query": {
                        "title": "Search query",
                        "type": "string",
                        "description": "Free-text search, same as typing into the search box on the directory page. Leave empty to fetch every record.",
                        "default": ""
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of records to scrape. Set to 0 to scrape the entire directory.",
                        "default": 0
                    },
                    "companyBatch": {
                        "title": "Batch (companies only)",
                        "type": "array",
                        "description": "Narrow down by YC batch, same as the Batch filter on the companies page. Ignored in founders mode.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Winter 2022",
                                "Summer 2021",
                                "Winter 2021",
                                "Winter 2023",
                                "Winter 2024",
                                "Summer 2024",
                                "Summer 2022",
                                "Winter 2020",
                                "Summer 2023",
                                "Summer 2020",
                                "Winter 2026",
                                "Spring 2026",
                                "Winter 2019",
                                "Summer 2019",
                                "Winter 2025",
                                "Summer 2025",
                                "Fall 2025",
                                "Winter 2018",
                                "Spring 2025",
                                "Summer 2026",
                                "Summer 2018",
                                "Summer 2017",
                                "Winter 2016",
                                "Winter 2017",
                                "Winter 2015",
                                "Summer 2015",
                                "Summer 2016",
                                "Fall 2024",
                                "Summer 2012",
                                "Summer 2014",
                                "Winter 2014",
                                "Winter 2012",
                                "Summer 2011",
                                "Summer 2013",
                                "Winter 2013",
                                "Winter 2011",
                                "Summer 2010",
                                "Winter 2010",
                                "Summer 2009",
                                "Summer 2008",
                                "Winter 2008",
                                "Summer 2007",
                                "Winter 2009",
                                "Winter 2007",
                                "Summer 2006",
                                "Summer 2005",
                                "Winter 2006",
                                "Fall 2026",
                                "Unspecified",
                                "Winter 2027"
                            ]
                        },
                        "default": []
                    },
                    "founderBatch": {
                        "title": "Batch (founders only)",
                        "type": "array",
                        "description": "Narrow down by YC batch, same as the Batch filter on the founders page. Ignored in companies mode.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "S21",
                                "W22",
                                "W21",
                                "W23",
                                "S24",
                                "W24",
                                "S22",
                                "S23",
                                "W20",
                                "S20",
                                "W19",
                                "W26",
                                "P26",
                                "S19",
                                "W25",
                                "S25",
                                "P25",
                                "F25",
                                "W18",
                                "S18",
                                "S26",
                                "S17",
                                "W16",
                                "W15",
                                "W17",
                                "S16",
                                "S15",
                                "S12",
                                "F24",
                                "S14",
                                "W14",
                                "W12",
                                "S11",
                                "S13",
                                "W13",
                                "W11",
                                "S10",
                                "S09",
                                "W10",
                                "S08",
                                "W08",
                                "S07",
                                "W09",
                                "W07",
                                "S06",
                                "W06",
                                "S05",
                                "F26",
                                "W27"
                            ]
                        },
                        "default": []
                    },
                    "companyRegions": {
                        "title": "Region (companies only)",
                        "type": "array",
                        "description": "Narrow down by region, same as the Region filter on the companies page. Ignored in founders mode.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "America / Canada",
                                "United States of America",
                                "Remote",
                                "Partly Remote",
                                "Fully Remote",
                                "Europe",
                                "South Asia",
                                "United Kingdom",
                                "Latin America",
                                "India",
                                "Canada",
                                "Unspecified",
                                "Southeast Asia",
                                "Mexico",
                                "Middle East and North Africa",
                                "Africa",
                                "France",
                                "Germany",
                                "Nigeria",
                                "Singapore",
                                "Brazil",
                                "Israel",
                                "Colombia",
                                "Indonesia",
                                "East Asia",
                                "Spain",
                                "Argentina",
                                "Oceania",
                                "Sweden",
                                "Chile",
                                "Australia",
                                "Netherlands",
                                "United Arab Emirates",
                                "Denmark",
                                "Egypt",
                                "Switzerland",
                                "Pakistan",
                                "Kenya",
                                "Peru",
                                "Philippines",
                                "South Korea",
                                "Hong Kong",
                                "Ireland",
                                "Malaysia",
                                "Norway",
                                "China",
                                "Panama",
                                "Poland",
                                "Slovenia",
                                "Turkey",
                                "Vietnam",
                                "Austria",
                                "Ghana",
                                "Portugal",
                                "Saudi Arabia",
                                "Belgium",
                                "Estonia",
                                "Finland",
                                "Morocco",
                                "Romania",
                                "Senegal",
                                "South Africa",
                                "Costa Rica",
                                "Croatia",
                                "Georgia",
                                "Italy",
                                "Jordan",
                                "New Zealand",
                                "Puerto Rico",
                                "Uganda",
                                "Ukraine",
                                "Uruguay",
                                "Algeria",
                                "Asia",
                                "Bahrain",
                                "Bangladesh",
                                "Belarus",
                                "Bulgaria",
                                "Cyprus",
                                "Czechia",
                                "Democratic Republic of the Congo",
                                "Ecuador",
                                "Ethiopia",
                                "Greece",
                                "Hungary",
                                "Iceland",
                                "Iraq",
                                "Ivory Coast",
                                "Japan",
                                "Kyrgyzstan",
                                "Latvia",
                                "Lithuania",
                                "Namibia",
                                "Nepal",
                                "Russia",
                                "Seychelles",
                                "Taiwan",
                                "Tanzania",
                                "Thailand",
                                "Venezuela",
                                "Zambia"
                            ]
                        },
                        "default": []
                    },
                    "founderRegions": {
                        "title": "Region (founders only)",
                        "type": "array",
                        "description": "Narrow down by region, same as the Region filter on the founders page. Ignored in companies mode.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "United States of America",
                                "United Kingdom",
                                "India",
                                "Canada",
                                "Unspecified",
                                "France",
                                "Germany",
                                "Mexico",
                                "Brazil",
                                "Singapore",
                                "Israel",
                                "Spain",
                                "Sweden",
                                "Australia",
                                "Indonesia",
                                "United Arab Emirates",
                                "Netherlands",
                                "Argentina",
                                "Switzerland",
                                "Nigeria",
                                "Colombia",
                                "Denmark",
                                "South Korea",
                                "Chile",
                                "Portugal",
                                "Hong Kong",
                                "Ireland",
                                "Poland",
                                "Malaysia",
                                "Norway",
                                "Philippines",
                                "Austria",
                                "Kenya",
                                "Belgium",
                                "Egypt",
                                "China",
                                "Pakistan",
                                "Japan",
                                "Vietnam",
                                "Puerto Rico",
                                "Saudi Arabia",
                                "Peru",
                                "Slovenia",
                                "Italy",
                                "Panama",
                                "Thailand",
                                "New Zealand",
                                "Finland",
                                "Romania",
                                "Croatia",
                                "Czechia",
                                "Estonia",
                                "Hungary",
                                "Morocco",
                                "Turkey",
                                "Uruguay",
                                "Bulgaria",
                                "Cyprus",
                                "Ghana",
                                "Greece",
                                "South Africa",
                                "Taiwan",
                                "Armenia",
                                "Costa Rica",
                                "Georgia",
                                "Jordan",
                                "Slovakia",
                                "Ukraine",
                                "Kazakhstan",
                                "Lithuania",
                                "Qatar",
                                "Albania",
                                "Bangladesh",
                                "Cameroon",
                                "Cayman Islands",
                                "Iceland",
                                "Iraq",
                                "Latvia",
                                "Malta",
                                "Monaco",
                                "Russia",
                                "Senegal",
                                "Serbia",
                                "Tanzania",
                                "Venezuela",
                                "Algeria",
                                "Andorra",
                                "Bahrain",
                                "Belarus",
                                "Benin",
                                "Bermuda",
                                "Bolivia",
                                "Dominican Republic",
                                "Ecuador",
                                "Ethiopia",
                                "Guatemala",
                                "Honduras",
                                "Ivory Coast",
                                "Kyrgyzstan",
                                "Luxembourg",
                                "Nepal",
                                "Oman",
                                "Uganda",
                                "United States Virgin Islands",
                                "Zambia"
                            ]
                        },
                        "default": []
                    },
                    "industries": {
                        "title": "Industry (companies only)",
                        "type": "array",
                        "description": "Narrow down by industry, same as the Industry filter on the companies page. Ignored in founders mode.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "B2B",
                                "Consumer",
                                "Healthcare",
                                "Fintech",
                                "Engineering, Product and Design",
                                "Industrials",
                                "Infrastructure",
                                "Productivity",
                                "Marketing",
                                "Real Estate and Construction",
                                "Operations",
                                "Healthcare IT",
                                "Finance and Accounting",
                                "Sales",
                                "Supply Chain and Logistics",
                                "Retail",
                                "Analytics",
                                "Manufacturing and Robotics",
                                "Payments",
                                "Education",
                                "Home and Personal",
                                "Security",
                                "Consumer Health and Wellness",
                                "Social",
                                "Content",
                                "Food and Beverage",
                                "Consumer Finance",
                                "Housing and Real Estate",
                                "Human Resources",
                                "Recruiting and Talent",
                                "Credit and Lending",
                                "Healthcare Services",
                                "Banking and Exchange",
                                "Gaming",
                                "Therapeutics",
                                "Aviation and Space",
                                "Insurance",
                                "Drug Discovery and Delivery",
                                "Legal",
                                "Diagnostics",
                                "Asset Management",
                                "Climate",
                                "Construction",
                                "Energy",
                                "Apparel and Cosmetics",
                                "Consumer Electronics",
                                "Medical Devices",
                                "Government",
                                "Travel, Leisure and Tourism",
                                "Industrial Bio",
                                "Agriculture",
                                "Transportation Services",
                                "Office Management",
                                "Drones",
                                "Automotive",
                                "Defense",
                                "Job and Career Services",
                                "Virtual and Augmented Reality",
                                "Unspecified"
                            ]
                        },
                        "default": []
                    },
                    "tags": {
                        "title": "Tags (companies only)",
                        "type": "array",
                        "description": "Narrow down by tag, same as the Tags filter on the companies page. Ignored in founders mode.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "B2B",
                                "SaaS",
                                "Artificial Intelligence",
                                "AI",
                                "Fintech",
                                "Developer Tools",
                                "Marketplace",
                                "Generative AI",
                                "Consumer",
                                "E-commerce",
                                "Machine Learning",
                                "Healthcare",
                                "Analytics",
                                "Health Tech",
                                "Open Source",
                                "Education",
                                "Productivity",
                                "AI Assistant",
                                "Payments",
                                "Hardware",
                                "Biotech",
                                "Climate",
                                "API",
                                "Logistics",
                                "Enterprise Software",
                                "Robotics",
                                "Infrastructure",
                                "Sales",
                                "Enterprise",
                                "Digital Health",
                                "Hard Tech",
                                "Consumer Health Services",
                                "Marketing",
                                "Data Engineering",
                                "Finance",
                                "Automation",
                                "Security",
                                "Crypto / Web3",
                                "Manufacturing",
                                "Gaming",
                                "Video",
                                "Supply Chain",
                                "Proptech",
                                "Real Estate",
                                "Workflow Automation",
                                "Computer Vision",
                                "Insurance",
                                "Social",
                                "HR Tech",
                                "Compliance",
                                "Construction",
                                "Medical Devices",
                                "Recruiting",
                                "AIOps",
                                "Community",
                                "Investing",
                                "Design Tools",
                                "Delivery",
                                "LegalTech",
                                "Neobank",
                                "eLearning",
                                "Travel",
                                "Entertainment",
                                "GovTech",
                                "Cloud Computing",
                                "DevOps",
                                "Food Tech",
                                "Retail",
                                "Conversational AI",
                                "Cybersecurity",
                                "Energy",
                                "Advertising",
                                "Therapeutics",
                                "AI-Enhanced Learning",
                                "Collaboration",
                                "Health & Wellness",
                                "IoT",
                                "Aerospace",
                                "Messaging",
                                "Deep Learning",
                                "Media",
                                "Sales Enablement",
                                "Healthcare IT",
                                "Legal",
                                "Operations",
                                "Mental Health Tech",
                                "Subscriptions",
                                "India",
                                "Transportation",
                                "AI-powered Drug Discovery",
                                "Agriculture",
                                "Creator Economy",
                                "DevSecOps",
                                "Documents",
                                "No-code",
                                "Social Media",
                                "Drug discovery",
                                "Reinforcement Learning",
                                "Robotic Process Automation",
                                "Consumer Finance",
                                "Diagnostics",
                                "Synthetic Biology",
                                "ClimateTech",
                                "Drones",
                                "Grocery",
                                "Big Data",
                                "Customer Support",
                                "Data Science",
                                "Data Visualization",
                                "FinOps",
                                "Industrial",
                                "Telehealth",
                                "Telemedicine",
                                "Banking as a Service",
                                "Design",
                                "Food & Beverage",
                                "Genomics",
                                "Health Insurance",
                                "Customer Success",
                                "Email",
                                "Telecommunications",
                                "Nonprofit",
                                "Augmented Reality",
                                "Databases",
                                "Automotive",
                                "Electric Vehicles",
                                "CRM",
                                "Customer Service",
                                "Social Network",
                                "Web Development",
                                "Human Resources",
                                "ML",
                                "NLP",
                                "Oncology",
                                "Satellites",
                                "Defense",
                                "Fashion",
                                "Housing",
                                "Latin America",
                                "Music",
                                "Search",
                                "Solar Power",
                                "Edtech",
                                "Fitness",
                                "Privacy",
                                "Regtech",
                                "Data Labeling",
                                "Lending",
                                "Market Research",
                                "Renewable Energy",
                                "Retail Tech",
                                "Sports Tech",
                                "SMB",
                                "Space Exploration",
                                "Biotechnology",
                                "Identity",
                                "Neurotechnology",
                                "Payroll",
                                "Remote Work",
                                "Semiconductors",
                                "Sustainability",
                                "Monitoring",
                                "Restaurant Tech",
                                "Team Collaboration",
                                "Women's Health",
                                "Energy Storage",
                                "Gene Therapy",
                                "Warehouse Management Tech",
                                "Home Services",
                                "Kubernetes",
                                "Mobility",
                                "Procurement",
                                "Trading",
                                "Virtual Reality",
                                "Carbon Capture and Removal",
                                "DeFi",
                                "Electronics",
                                "Scheduling",
                                "3D Printing",
                                "APIs",
                                "Airplanes",
                                "Autonomous Trucking",
                                "Consumer Products",
                                "Cryptocurrency",
                                "Ghost Kitchens",
                                "Personalization",
                                "Beauty",
                                "Chatbot",
                                "Food Service Robots & Machines",
                                "Nanotechnology",
                                "Call Center",
                                "Crowdfunding",
                                "Emerging Markets",
                                "Food",
                                "Fraud Detection",
                                "Kids",
                                "Sleep Tech",
                                "Sustainable Fashion",
                                "Autonomous Delivery",
                                "Civic Tech",
                                "Fertility Tech",
                                "Investments",
                                "Mental Health",
                                "Metaverse",
                                "Primary Care",
                                "AR",
                                "Anti-Aging",
                                "Biometrics",
                                "Calendar",
                                "Cannabis",
                                "Podcasts",
                                "SMS",
                                "Smart Home Assistants",
                                "Talent Acquisition",
                                "Advanced Materials",
                                "Assistive Tech",
                                "Cellular Agriculture",
                                "Chat",
                                "Commercial Space Launch",
                                "Dating",
                                "Dental",
                                "Drug Delivery",
                                "Feedback",
                                "Furniture",
                                "Immigration",
                                "International",
                                "Live",
                                "Mining",
                                "Remittances",
                                "Remote",
                                "Self-Driving Vehicles",
                                "Speech Recognition",
                                "Air Taxis",
                                "Airlines",
                                "Auto Commerce",
                                "Billing",
                                "Careers",
                                "Cashierless Checkout",
                                "Cell Therapy",
                                "Cloud Workload Protection",
                                "Crowdsourcing",
                                "Femtech",
                                "Fraud Prevention",
                                "Geographic Information System",
                                "Medical Robotics",
                                "Microfluidics",
                                "Nanomedicine",
                                "Nanosensors",
                                "Next-gen Network Security",
                                "Note-taking",
                                "Smart Clothing",
                                "Stocks",
                                "Apparel",
                                "Architecture",
                                "COVID-19",
                                "CRISPR",
                                "Genetic Engineering",
                                "Home Automation",
                                "Hydrogen Energy",
                                "Income Share Agreements",
                                "Industrial Workplace Safety",
                                "NFT",
                                "Navigation",
                                "Networks",
                                "Quantum Computing",
                                "Recommendation System",
                                "Rocketry",
                                "SEO",
                                "Unmanned Vehicle",
                                "Bioplastic",
                                "Booking",
                                "Chatbots",
                                "China",
                                "Cryptography",
                                "Culture",
                                "Cultured Meat",
                                "Digital Freight Brokerage",
                                "Diversity & Inclusion",
                                "Edge Computing Semiconductors",
                                "Fundraising",
                                "Fusion Energy",
                                "GraphQL",
                                "Location-based",
                                "Maritime",
                                "Microinsurance",
                                "Pediatrics",
                                "Reviews",
                                "Robotic Surgery",
                                "Sustainable Agriculture",
                                "Sustainable Tourism",
                                "Swarm Robotics",
                                "Time Series",
                                "Trust & Safety",
                                "Weather",
                                "eSports",
                                "Alternative Battery Tech",
                                "Alternative Fuels",
                                "Blockchain",
                                "Cloud Gaming",
                                "Coding Bootcamps",
                                "Conversational Banking",
                                "Cultivated Meat",
                                "Customization",
                                "DAO",
                                "Election Tech",
                                "Indoor Mapping",
                                "IoT Security",
                                "Notifications",
                                "Plant-based Meat",
                                "Radar",
                                "Referrals",
                                "Ridesharing",
                                "Skincare",
                                "Small Modular Reactors",
                                "Ticketing",
                                "VR Health",
                                "Vertical Farming",
                                "3D Printed Foods",
                                "Art Trading Platforms",
                                "Autonomous Shipping",
                                "Batteryless IoT Sensors",
                                "Clean Meat",
                                "Computational Storage",
                                "Cyber Insurance",
                                "Deepfake Detection",
                                "Gardening",
                                "Lab-on-a-chip",
                                "Lidar",
                                "Livestock Health",
                                "Psychedelics",
                                "Security Orchestration, Automation and Response (SOAR)",
                                "Smart Locks",
                                "Smart Waste Management"
                            ]
                        },
                        "default": []
                    },
                    "status": {
                        "title": "Company status (companies only)",
                        "type": "array",
                        "description": "Narrow down by company status, same as the Status filter on the companies page. Ignored in founders mode.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Active",
                                "Inactive",
                                "Acquired",
                                "Public"
                            ]
                        },
                        "default": []
                    },
                    "isHiring": {
                        "title": "Only hiring companies (companies only)",
                        "type": "boolean",
                        "description": "Same as the \"Is Hiring\" filter on the companies page. Ignored in founders mode.",
                        "default": false
                    },
                    "ycTitles": {
                        "title": "Role (founders only)",
                        "type": "array",
                        "description": "Narrow down by role, same as the Role filter on the founders page. Shows the most common roles; ignored in companies mode.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Founder",
                                "CEO",
                                "CTO",
                                "Co-Founder",
                                "Co-founder & CEO",
                                "Founder/CEO",
                                "COO",
                                "Founder & CEO",
                                "Co-founder & CTO",
                                "Founder/CTO",
                                "CPO",
                                "CEO & Co-Founder",
                                "President",
                                "Co-Founder and CEO",
                                "Co-Founder and CTO",
                                "Founder & CTO",
                                "Founder and CEO",
                                "Co-Founder, CEO",
                                "Founder, CEO",
                                "Co-Founder, CTO",
                                "Founder / CEO",
                                "CMO",
                                "CSO",
                                "CTO & Co-Founder",
                                "Co-founder/CEO",
                                "CEO & Founder",
                                "Co-Founder / CEO",
                                "Co-Founder / CTO",
                                "Cofounder",
                                "Head of Product"
                            ]
                        },
                        "default": []
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
