AniList API

Search AniList anime and manga and pull characters, reviews and user lists as clean JSON.

The API.SH AniList API returns AniList data as plain REST JSON. Search anime and manga with every AniList filter, list a broadcast season or the top, trending and upcoming charts, and open any title by AniList id, link or MyAnimeList id for scores, popularity, studios, tags, streaming links, rankings and related titles. Also get characters with voice actors, staff, recommendations, user reviews, and public user profiles and anime or manga lists.

Get a free API key Try it in the playground

10 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

AniList anime and manga search

GET https://api.api.sh/anilist/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the AniList API

Anime discovery apps

Search by genre, tag, season, format and score, or show seasonal and trending charts with covers, descriptions and next airing episodes.

/search /seasonal /top

Discord and chat bots

Look up a title, its characters and voice actors, or the people behind it from a chat command.

/media /characters /staff

List export and stats

Export a user's public anime or manga list with status, score, progress and dates, and read their profile statistics.

/user/list /user

Recommendation engines

Combine AniList users' recommendations with genres, tags and scores to suggest what to watch or read next.

/recommendations /media

Review and score analysis

Pull full reviews with scores and helpful votes, plus score and status distributions, to study how fans rate a title.

/reviews /media

AniList data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

AniList API endpoints and prices

Every AniList endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2

AniList anime and manga search /anilist/v1/search	$1 · $2 PAYG 1 credit
AniList top anime and manga /anilist/v1/top	$1 · $2 PAYG 1 credit

Profiles and accounts2

AniList user profile /anilist/v1/user	$1 · $2 PAYG 1 credit
AniList user anime or manga list /anilist/v1/user/list	$1 · $2 PAYG 1 credit

Posts and media1

AniList anime or manga

/anilist/v1/media

$1 · $2 PAYG

1 credit

Comments and reviews1

AniList reviews

/anilist/v1/reviews

$1 · $2 PAYG

1 credit

More data4

AniList characters and voice actors /anilist/v1/characters	$1 · $2 PAYG 1 credit
AniList recommendations /anilist/v1/recommendations	$1 · $2 PAYG 1 credit
AniList seasonal anime /anilist/v1/seasonal	$1 · $2 PAYG 1 credit
AniList staff and voice actor /anilist/v1/staff	$1 · $2 PAYG 1 credit

Call the AniList API

AniList anime and manga search: GET https://api.api.sh/anilist/v1/search

curl "https://api.api.sh/anilist/v1/search?q=frieren" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/anilist/v1/search",
    params={"q": "frieren"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/anilist/v1/search");
url.searchParams.set("q", "frieren");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/anilist/v1/search", "q", "frieren")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "AniList" and "AniList anime and manga search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for AniList data

Public data only: no AniList login, cookies or account needed
One key and one response shape for AniList and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official AniList API

Yes. AniList has a free public GraphQL API that needs no key for public data and has a per-minute rate limit; OAuth is needed only for private lists and updates. API.SH wraps the public data in simple REST endpoints with named parameters, accepts MyAnimeList ids, and returns the same JSON shape it uses for other anime and media sites, so you don't write GraphQL queries.

If you would rather not write GraphQL or run your own AniList scraper, API.SH gives you plain REST calls with one key and fixed pricing.

AniList API questions

What AniList data can I get?+

Search (/anilist/v1/search), seasonal anime (/anilist/v1/seasonal), top charts (/anilist/v1/top), one title (/anilist/v1/media), characters and voice actors (/anilist/v1/characters), staff (/anilist/v1/staff), recommendations (/anilist/v1/recommendations), reviews (/anilist/v1/reviews), user profiles (/anilist/v1/user) and user lists (/anilist/v1/user/list).

How much does the AniList API cost?+

Every AniList endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /anilist/v1/characters at 1 credit each.

Is the AniList API free?+

Yes. AniList's official GraphQL API is free for public data within its rate limit. API.SH is a paid, plain REST alternative for people who want simple parameters, MyAnimeList id lookups and the same JSON format across sources.

Do I need an AniList account or token?+

No. API.SH reads public AniList data only. No endpoint uses a login, OAuth token or anyone's account, so private lists are not available.

How do I export data from AniList?+

Call /anilist/v1/user/list with a user name and type (anime or manga) to get every title on a public list with status, score, progress, rewatches, notes and dates, 50 per page, as JSON or CSV.

Can I look up titles by MyAnimeList id?+

Yes. /anilist/v1/media, characters, recommendations and reviews accept mal_id, and every result includes the MyAnimeList id, so you can match the two databases.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /anilist/v1/search with q set to a title, or /anilist/v1/seasonal for this season. Docs are at https://api.sh/docs, with JS and Python SDKs, Google Sheets, Zapier, Make, n8n and the MCP server at https://api.sh/mcp.