# Y Combinator · Search

Find companies, people and contact details with Y Combinator · Search from Alexandria through one Spiral API key. Browse or search the public YC company directory. Query is optional: omit it to list every company matching the exact source labels for batch (e.g. Summer 2025), industry, region, status and tag, or the hiring, top company and nonprofit flags. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `ycombinator-com/companies/search`
- Page: https://spiral.ai/tools/alexandria/ycombinator-com/companies/search

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `tag` | text |  | — | Exact tag label, e.g. Developer Tools, AI, Open Source. |
| `url` | text |  | — | A pasted https://www.ycombinator.com/companies URL (its query, batch, industry, regions, tags, status, isHiring, top_company and nonprofit parameters; short batch codes like W25 are expanded) or /companies/industry/<slug> (matched to the directory's industry label, else its tag label). Explicit inputs take precedence over URL values. |
| `page` | number | 0 to 49 | 0 | Zero-based page; next_page in the output gives the following page or null when exhausted. |
| `batch` | text |  | — | Exact batch label as published by YC, e.g. Summer 2025 or Winter 2022. Use the batches function to list valid labels. |
| `query` | text |  |  | Free-text search over company names and descriptions. Omit or leave empty to browse by filters only. |
| `hiring` | true or false |  | — | Only companies the directory flags as hiring (true) or not hiring (false). |
| `region` | text |  | — | Exact region label, e.g. America / Canada, United States of America, Europe, Remote. |
| `status` | one of | Active, Acquired, Public, Inactive | — | Source-reported company status. |
| `industry` | text |  | — | Exact industry label, e.g. B2B, Consumer, Healthcare, Fintech. |
| `nonprofit` | true or false |  | — | Only nonprofit companies. |
| `top_company` | true or false |  | — | Only companies on the YC Top Companies list. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "ycombinator-com/companies/search",
    "input": {
      "tag": "<tag>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=ycombinator-com%2Fcompanies%2Fsearch

## Common questions

### Y Combinator · Search

**How much does Y Combinator · Search cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Y Combinator · Search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "ycombinator-com/companies/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Y Combinator · Search?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Y Combinator · Search?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

