# Bookface 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.

> Search and retrieve detailed information about Y Combinator portfolio companies, including founder details, company profiles, recent launches, and current job openings. Easily discover startups by browsing the complete directory or looking up specific companies to learn about their founders, news, and hiring opportunities.

**Category:** Business Directories | **Website:** [bookface.ycombinator.com/company/30846](https://bookface.ycombinator.com/company/30846) | **Docs:** [parse.bot/marketplace/e702b5ab-bdb2-4408-9380-6949a8590726/bookface-ycombinator-com-api](https://parse.bot/marketplace/e702b5ab-bdb2-4408-9380-6949a8590726/bookface-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-bookface-ycombinator-com-api-e702b5ab/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company

Get detailed company information by Bookface company ID or URL slug. Returns comprehensive data including founders, launches, news items, social links, and group partner. One of company_id or slug is required.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_id` | string | No | Bookface company ID (e.g., '30846'). Either company_id or slug is required. |
| `slug` | string | No | Company URL slug (e.g., 'parse-bot'). Either company_id or slug is required. |

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

### search_companies

Search YC companies by keyword query with optional batch filtering and pagination. Returns matching companies from the Algolia-powered directory. At least one of query or batch is required.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `batch` | string | No | Filter by YC batch using full season and year format (e.g., 'Fall 2025', 'Summer 2024', 'Winter 2024'). |
| `limit` | integer | No | Results per page (max 1000). |
| `page` | integer | No | Page number (0-indexed). |
| `query` | string | No | Search keyword (e.g., 'AI', 'fintech'). At least one of query or batch is required. |

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