# Bookface Ycombinator — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

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

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.beta.paywithlocus.com/api/wrapped/credits/bookface-ycombinator/get-company \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/bookface-ycombinator/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"batch":"<string>","limit":"<integer>","page":"<integer>","query":"<string>"}'
```

## Next steps

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