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

> Access the latest anime news, reviews, ratings, and release schedules from Anime News Network. Retrieve top-rated anime rankings, read professional reviews, look up detailed series information, and browse upcoming premiere dates.

**Category:** Entertainment | **Website:** [animenewsnetwork.com/](https://animenewsnetwork.com/) | **Docs:** [parse.bot/marketplace/6fc4db1c-1858-4d50-bdad-f06c2d43a645/animenewsnetwork-com-api](https://parse.bot/marketplace/6fc4db1c-1858-4d50-bdad-f06c2d43a645/animenewsnetwork-com-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-animenewsnetwork-com-api-6fc4db1c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_anime_details

Get detailed information about a specific anime series from the ANN encyclopedia API, including ratings, episode list, genres, themes, and plot summary. Provide either an anime_id or a search query; at least one is required. When using query, returns the first matching result.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `anime_id` | string | No | The ANN encyclopedia numeric ID of the anime (e.g. '10216' for Fullmetal Alchemist: Brotherhood). Can be obtained from get_top_anime results. |
| `query` | string | No | Search query to find an anime by title (e.g. 'Fullmetal Alchemist'). Used if anime_id is not provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-animenewsnetwork-com-api-6fc4db1c/get_anime_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"anime_id":"<string>","query":"<string>"}'
```

### get_recent_news

Fetch the most recent news articles from Anime News Network via their RSS feed. Returns article titles, URLs, publication dates, authors, and content snippets. Articles are ordered newest-first. Each article requires an individual page fetch for full content, so larger limits are slower.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of news articles to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-animenewsnetwork-com-api-6fc4db1c/get_recent_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_release_schedule

Get the upcoming TV anime release schedule from the ANN encyclopedia. Returns anime IDs, titles, and premiere dates for upcoming series, ordered by release date ascending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of upcoming releases to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-animenewsnetwork-com-api-6fc4db1c/get_release_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_reviews

Fetch recent reviews of anime, manga, and games from Anime News Network. Returns review titles, URLs, reviewers, letter-grade ratings, dates, and full review text. Each review requires an individual page fetch, so larger limits are slower.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of reviews to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-animenewsnetwork-com-api-6fc4db1c/get_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_top_anime

Fetch top-rated anime series from the ANN encyclopedia Bayesian rating report. Returns anime IDs, titles, vote counts, and various rating averages. Results are ordered by Bayesian average descending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of top anime entries to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-animenewsnetwork-com-api-6fc4db1c/get_top_anime \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```