# Startups (startups.rip) — 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.

> Search and analyze data on 1,700+ Y Combinator startups, including their current status (active, acquired, or defunct), company details, and research reports organized by batch. Find similar companies, browse startups by cohort, and discover insights about YC's portfolio ecosystem.

**Category:** Business Directories | **Website:** [startups.rip/](https://startups.rip/) | **Docs:** [parse.bot/marketplace/8191d50b-107d-4686-816f-2cbabef40f53/startups-rip-api](https://parse.bot/marketplace/8191d50b-107d-4686-816f-2cbabef40f53/startups-rip-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-startups-rip-api-8191d50b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company

Get detailed information about a specific company including name, batch, status, category, one-liner, logo, founders text, and full research report sections (Overview, Founding Story, Timeline, What They Built, Market Position, Business Model, Traction, Post-Mortem, Key Lessons, Sources). Some companies may have partial report content or missing fields. Free reports are fully available; locked reports show a placeholder message.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Company slug from search_companies results or list_companies_by_batch results (e.g., 'airbnb', '42floors', 'basilica'). |

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

### get_similar_companies

Get companies similar to a given company, filtered by category. Results are determined by the site's similarity algorithm. Returns up to ~5 similar companies with basic info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category to filter by, as returned by list_batches categories (e.g., 'Community', 'Marketplace', 'SaaS'). |
| `slug` | string | Yes | Company slug from search_companies or list_companies_by_batch results (e.g., 'airbnb', 'stripe'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-startups-rip-api-8191d50b/get_similar_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","slug":"<string>"}'
```

### list_batches

List all available YC batches and categories from the browse page. Returns 40 batches (Summer 2005 through Spring 2025) and 147 categories. Single-page response with no pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-startups-rip-api-8191d50b/list_batches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_companies_by_batch

List companies in a specific YC batch. Returns company slugs, names, statuses, categories, and logo URLs. Batch names come from the list_batches endpoint. Some older batches may return fewer results due to limited data coverage.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `batch` | string | Yes | Batch name as returned by list_batches (e.g., 'Winter 2019', 'Summer 2021', 'Spring 2025'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-startups-rip-api-8191d50b/list_companies_by_batch \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"batch":"<string>"}'
```

### search_companies

Full-text search over YC startups by keyword. Matches against company name, one-liner, and category. Returns up to 20 results per call with basic info. No pagination beyond the server cap of 20 results per query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return (server caps at 20). |
| `query` | string | Yes | Search keyword (e.g., 'airbnb', 'marketplace', 'fintech') |

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