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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-tapas-io-api-5b97d8b9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-tapas-io-api-5b97d8b9/get_item_episodes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tapas-io-api-5b97d8b9/get_item_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tapas-io-api-5b97d8b9/search_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_number":"<integer>","query":"<string>","type_filter":"<string>"}'
```