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

> Look up detailed information about any comic or novel on Tapas.io to view titles, cover images, reader statistics, author names, and story synopses all in one place. Perfect for discovering new series or getting comprehensive details about your favorite Tapas stories.

**Category:** Entertainment | **Website:** [tapas.io/series/my-werewolf-system-novel/info](https://tapas.io/series/my-werewolf-system-novel/info) | **Docs:** [parse.bot/marketplace/5b97d8b9-b156-4325-a839-810c0d8cfe72/tapas-io-api](https://parse.bot/marketplace/5b97d8b9-b156-4325-a839-810c0d8cfe72/tapas-io-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/tapas/`
**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 item episodes

Retrieve the list of episodes/chapters for a Tapas series given its URL slug. Returns paginated results (20 per page) including episode page URL, cover image, episode number, title, release date, and view count. Page 1 is fetched from the series info page (includes release date and views); subsequent pages use the episodes API (release_date and views will be null). Makes 1 request for page 1, 2 requests for page 2+.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for episode pagination. Each page returns up to 20 episodes. |
| `series_slug` | string | Yes | The URL slug of the series on Tapas (the part after /series/ in the URL). For example, 'my-werewolf-system-novel'. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tapas/get-item-episodes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","series_slug":"<string>"}'
```

### Get item info

Retrieve detailed information about a Tapas series (comic or novel) given its URL slug. Returns the page URL, title, poster image, cover image, category/genre, series type (Novel or Comic), view count, subscriber count, like count, chapter/episode count, author name, and synopsis. Makes one HTTP request to the series info page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `series_slug` | string | Yes | The URL slug of the series on Tapas (the part after /series/ in the URL). For example, 'my-werewolf-system-novel' or 'tbate-comic'. |

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

### Search items

Search for series on Tapas by title with optional type filter and pagination. Returns up to 10 results per page, each containing the series page URL, cover image, title, author, synopsis, and tags. Makes one HTTP request to the Tapas search page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page_number` | integer | No | Page number for search result pagination. |
| `query` | string | Yes | Search query string (title to search for). |
| `type_filter` | string | No | Filter results by content type. One of COMICS, NOVELS, PEOPLE, or TAG. Omit to search all types. |

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