# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/ycombinator/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/ycombinator/get-company \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ycombinator/get-library \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ycombinator/get-partners \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ycombinator/get-person-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ycombinator/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ycombinator/search-founders \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ycombinator/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"role":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.