# Espressif — 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.

> Access official Espressif technical documentation including datasheets, reference manuals, hardware design guidelines, and user guides across different chip series. Search and retrieve the specific technical resources you need for your Espressif microcontroller projects.

**Category:** Developer Tools | **Website:** [espressif.com/](https://espressif.com/) | **Docs:** [parse.bot/marketplace/f0ee5fd6-da11-4d88-b883-f160fd0efef7/espressif-com-api](https://parse.bot/marketplace/f0ee5fd6-da11-4d88-b883-f160fd0efef7/espressif-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/espressif/`
**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 document types

Retrieves all available document type categories. Each type has a unique ID and name. Includes categories like Datasheet, Errata, Reference, Guide, Application Note, PCN, and various certifications. The full list is returned in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/espressif/get-document-types \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get series

Retrieves all Espressif chip series (product families). Each series has a unique ID, English name, and Chinese name. The full catalog is returned in a single response with no pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/espressif/get-series \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search documents

Searches technical documents for a given chip series. Supports filtering by document type and keyword matching against title and summary. Returns all matching documents with metadata including title, summary, version, revision date, type, language, download link, and file size. Paginated internally; the full matching set is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `doc_type_id` | string | No | Filter by document type ID. Obtain valid IDs from the get_document_types endpoint. |
| `query` | string | No | Filter documents by keyword match in title or summary (case-insensitive). |
| `series_id` | string | No | Series ID to filter documents by. Obtain valid IDs from the get_series endpoint. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/espressif/search-documents \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"doc_type_id":"<string>","query":"<string>","series_id":"<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.