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

> Browse anime news, discover shows with detailed information and episode lists, and participate in community polls and discussions all from one unified service. Search across anime.com's comprehensive database to find exactly what you're looking for.

**Category:** Entertainment | **Website:** [anime.com/](https://anime.com/) | **Docs:** [parse.bot/marketplace/1589054e-e3eb-4f62-ba2a-ba8a0391da3d/anime-com-api](https://parse.bot/marketplace/1589054e-e3eb-4f62-ba2a-ba8a0391da3d/anime-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/anime/`
**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 news feed

Fetch the latest anime news articles from social media and official sources. Returns paginated results sorted by recency with cursor-based pagination. Each article includes a summary, content, author, and publication date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response's endCursor to fetch the next page. |
| `limit` | integer | No | Number of news items to fetch per page. |

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

### Get polls

Fetch community polls with their questions, options, and vote counts. Returns the most recent active polls.

**Estimated cost:** Metered

_No parameters required._

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

### Get show details

Fetch full details for a specific anime show by its slug, including description, genres, streaming platforms, episode and season counts, and ratings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Show slug identifier (e.g. 'naruto', 'one-piece', 'attack-on-titan'). Obtainable from search results or get_shows_list. |

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

### Get show episodes

Fetch the full episode list for a specific anime show, grouped by season. Returns all episodes across all seasons with titles, air dates, descriptions, and ratings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Show slug identifier (e.g. 'naruto', 'one-piece'). Obtainable from search results or get_shows_list. |

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

### Get shows list

Browse the anime shows catalog sorted by vote count in descending order. Returns paginated results with cursor-based pagination. The catalog includes all show types (series, OVA, ONA, specials, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response's endCursor to fetch the next page. |
| `limit` | integer | No | Number of shows to fetch per page. |

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

### Search

Search for anime shows by query string. Returns matching shows with basic metadata sorted by relevance. Supports semantic search.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string (e.g. 'naruto', 'one piece', 'demon slayer'). |

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