anime APIanime.com ↗
Access anime.com data via 6 endpoints: browse shows, search titles, fetch episode lists by season, read news articles, and retrieve community polls.
What is the anime API?
The anime.com API provides 6 endpoints covering the full anime.com catalog — shows, episodes, news, search, and community polls. Use get_show_details to retrieve a show's synopsis, genres, airing status, streaming platform links, and vote ratings by slug. Use get_show_episodes to pull every episode across all seasons, including air dates and per-episode ratings. The API returns structured JSON throughout, with cursor-based pagination on list endpoints.
curl -X GET 'https://api.parse.bot/scraper/94db79a7-96a7-45d7-9a7d-cac3e29322ae/get_news_feed?limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace anime-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Anime.com SDK — browse, search, drill into details and episodes."""
from parse_apis.anime_com_api import Anime, ShowStatus, ShowNotFound
client = Anime()
# Browse top-rated shows from the catalog, capped at 5 items.
for show in client.catalogs.list(limit=5):
print(show.title, show.vote_average, show.status)
# Search for a specific anime and drill into the first result's details.
result = client.catalogs.search(query="demon slayer", limit=1).first()
if result:
detail = result.details()
print(detail.title, detail.rating, detail.episode_count, detail.season_count)
# Walk episodes for that show (capped).
for ep in detail.episodes(limit=3):
print(ep.season, ep.episode, ep.title, ep.air_date)
# Fetch latest news articles.
for article in client.newsfeeds.list(limit=3):
print(article.title, article.author, article.published_at)
# Community polls.
for poll in client.communities.polls(limit=2):
print(poll.question, poll.total_votes)
# Typed error handling: attempt to fetch a non-existent show.
try:
client.shows.get(slug="nonexistent-show-xyz")
except ShowNotFound as exc:
print(f"Show not found: {exc.slug}")
print("exercised: catalogs.list / catalogs.search / show.details / show.episodes / newsfeeds.list / communities.polls / shows.get")
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.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of news items to fetch per page. |
| cursor | string | Pagination cursor from a previous response's endCursor to fetch the next page. |
{
"type": "object",
"fields": {
"items": "array of news article objects with id, title, summary, content, published_at, author, url, and cursor",
"endCursor": "string cursor for next page",
"hasNextPage": "boolean indicating if more pages exist"
},
"sample": {
"data": {
"items": [
{
"id": "019eb4d6-b50d-7eed-b411-cc6857ff2c75",
"url": "https://www.anime.com/post/019eb4d6-b50d-7eed-b411-cc6857ff2c75",
"title": "One Piece",
"author": "Eiichiro_Staff",
"cursor": "12.37:019eb4d6",
"content": "TV anime info...",
"summary": "One Piece Episode 1165 premieres.",
"published_at": "2026-06-11T04:00:11.000Z"
}
],
"endCursor": "7.07:019eb416",
"hasNextPage": true
},
"status": "success"
}
}About the anime API
Show Discovery and Search
The get_shows_list endpoint pages through the full anime catalog — series, OVA, ONA, specials, and more — sorted by vote_count descending. Each item returns id, slug, title, status, genres, poster_url, vote_average, and vote_count. Pagination is cursor-based: pass the endCursor from one response as the cursor parameter in the next call; check hasNextPage to know when to stop. The search endpoint accepts a query string and returns relevance-ranked results with the same core fields plus type, making it practical for autocomplete or title-lookup flows.
Show Details and Episodes
get_show_details takes a slug (obtainable from search or get_shows_list) and returns the full record for a single show: description, genres, status (e.g. AIRING or FINISHED), rating, vote_count, poster_url, and a streams array listing streaming platforms with their direct URLs. get_show_episodes returns all episodes for that slug, grouped by season and episode number, each with title, description, air_date, and vote_average.
News and Polls
get_news_feed returns paginated anime news articles sorted by recency. Each article object includes id, title, summary, content, author, published_at, and url. Pagination follows the same cursor model as the show list. get_polls returns the current set of active community polls with question, totalVotes, and a per-option breakdown of text, voteCount, and display order — no input parameters required.
The anime API is a managed, monitored endpoint for anime.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when anime.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official anime.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build an anime discovery app that ranks titles by
vote_averageand links out tostreamsplatform URLs. - Power a season/episode tracker by consuming
get_show_episodesand storingair_dateandvote_averageper episode. - Populate a search-as-you-type interface using the
searchendpoint withqueryand displayingposter_urlthumbnails. - Aggregate anime news into a digest or newsletter by polling
get_news_feedand filtering onpublished_at. - Display active fan sentiment by embedding
get_pollsresults with per-optionvoteCountbreakdowns. - Filter the catalog to currently-airing shows by reading the
statusfield fromget_shows_listresults. - Construct a show comparison tool using
vote_count,vote_average, andgenresfromget_show_details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does anime.com have an official developer API?+
What does `get_show_details` return that `get_shows_list` does not?+
get_shows_list returns summary fields suitable for browsing: slug, title, status, genres, poster_url, vote_average, and vote_count. get_show_details adds description (the full synopsis) and the streams array, which lists streaming platforms and their direct URLs for that specific show.How does pagination work across list endpoints?+
get_news_feed and get_shows_list endpoints use cursor-based pagination. Each response includes an endCursor string and a hasNextPage boolean. To fetch the next page, pass the endCursor value as the cursor parameter in your next request. When hasNextPage is false, you have reached the last page.Does the API return character or voice actor data for shows?+
Can I filter shows by genre or airing status directly?+
get_shows_list does not accept genre or status filter parameters — it returns results sorted by vote count and includes genres and status fields in each item for client-side filtering. The search endpoint supports free-text queries but not structured filters. You can fork this API on Parse and revise it to add genre or status filter parameters.