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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/startups-rip/`
**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

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/credits/startups-rip/get-company \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/startups-rip/get-similar-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/startups-rip/list-batches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/startups-rip/list-companies-by-batch \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/startups-rip/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<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.