# Ycombinator — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive data from the Y Combinator ecosystem, including company profiles, founder and partner information, job listings, and the YC library. Filter companies by batch, industry, and hiring status, and explore detailed profiles with social links, team information, and funding metadata.

**Category:** Business Directories | **Website:** [ycombinator.com/](https://ycombinator.com/) | **Docs:** [parse.bot/marketplace/fb192a9b-aff5-4232-9bb2-5dbb3523e401/ycombinator-com-api](https://parse.bot/marketplace/fb192a9b-aff5-4232-9bb2-5dbb3523e401/ycombinator-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ycombinator-com-api-fb192a9b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company

Retrieve full details for a YC company by its slug. Returns comprehensive company profile including founders with bios, social links, team size, description, and funding information. The slug is the URL-friendly company identifier (e.g. 'airbnb', 'coinbase').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Company slug identifier (e.g. 'airbnb', 'coinbase', 'stripe'). Obtainable from search_companies results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ycombinator-com-api-fb192a9b/get_company \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_library

Browse the YC Library for articles, videos, and podcasts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ycombinator-com-api-fb192a9b/get_library \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_partners

List all current YC Partners. Returns partner profiles with name, slug, title, short bio, and photo URLs. No pagination — returns the complete list in one call.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ycombinator-com-api-fb192a9b/get_partners \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_person_detail

Get a detailed profile for a YC partner by slug. Returns full biography, achievement stats, associated companies, blog posts, press articles, tweets, and videos. Only supports YC partner profiles (e.g. 'garry-tan', 'michael-seibel'); founder slugs will return not-found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | YC partner slug (e.g. 'garry-tan', 'michael-seibel', 'jared-friedman'). Obtain from get_partners results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ycombinator-com-api-fb192a9b/get_person_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### search_companies

Search and filter the YC company directory via Algolia. Returns paginated results with company metadata including name, batch, industry, team size, and hiring status. Supports faceted filtering by batch, industry, hiring status, and top-company designation. An empty query returns the full directory in default order.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `batch` | string | No | Filter by YC batch name (e.g. 'Winter 2024', 'Summer 2023'). |
| `industry` | string | No | Filter by industry (e.g. 'Fintech', 'B2B', 'Healthcare'). |
| `is_hiring` | string | No | Filter by hiring status. Accepts 'true' or 'false'. |
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number (0-indexed). |
| `query` | string | No | Search keyword to match against company name, description, and tags. |
| `top_company` | string | No | Filter for YC top companies. Accepts 'true' or 'false'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ycombinator-com-api-fb192a9b/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"batch":"<string>","industry":"<string>","is_hiring":"<string>","limit":"<integer>","page":"<integer>","query":"<string>","top_company":"<string>"}'
```

### search_founders

Search the YC founder directory via Algolia. Returns paginated results with founder metadata including name, current company, title, batches, and industries. An empty query returns the full founder index.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page. |
| `page` | integer | No | Page number (0-indexed). |
| `query` | string | No | Search keyword for founder name or company. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ycombinator-com-api-fb192a9b/search_founders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

### search_jobs

List job openings at YC companies from workatastartup.com, filtered by role category. Returns up to 30 jobs per call with title, salary range, location, and company info. Defaults to software-engineer when no role specified.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `role` | string | No | Role category filter. Accepted values: 'software-engineer', 'designer', 'recruiting', 'science', 'product', 'operations', 'sales', 'marketing', 'legal', 'finance'. Also accepts aliases: 'eng' or 'engineering' (maps to software-engineer), 'design' (maps to designer), 'ops' (maps to operations). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ycombinator-com-api-fb192a9b/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"role":"<string>"}'
```