Anime News Network APIanimenewsnetwork.com ↗
Access ANN news articles, anime reviews, top-rated rankings, series details, and premiere schedules via 5 structured JSON endpoints.
What is the Anime News Network API?
The Anime News Network API exposes 5 endpoints covering news, reviews, encyclopedia ratings, series details, and upcoming release schedules from animenewsnetwork.com. The get_anime_details endpoint alone returns up to seven structured fields per series — including episode lists, genre tags, plot summaries, and Bayesian scores — while get_top_anime surfaces ranked entries with vote counts and multiple rating averages drawn from the ANN encyclopedia.
curl -X GET 'https://api.parse.bot/scraper/9cbf5fbc-2873-48ce-87bb-1008ca5e3678/get_recent_news?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 animenewsnetwork-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: ANN SDK — discover top anime, drill into details, browse news and reviews."""
from parse_apis.anime_news_network_ann_api import ANN, AnimeNotFound
client = ANN()
# Browse top-rated anime — limit caps total items fetched.
for anime in client.animesummaries.list(limit=5):
print(anime.title, anime.bayesian_average)
# Drill into the #1 ranked anime for full details.
top = client.animesummaries.list(limit=1).first()
if top:
detail = top.details()
print(detail.name, detail.type, detail.ratings.bayesian_score)
for ep in detail.episodes[:3]:
print(ep.number, ep.title)
# Check upcoming releases.
for release in client.releases.list(limit=3):
print(release.title, release.release_date)
# Read latest news articles.
article = client.articles.list(limit=1).first()
if article:
print(article.title, article.author, article.publication_date)
# Typed error handling for anime lookup.
try:
bad = client.animesummaries.list(limit=1).first()
if bad:
bad.details()
except AnimeNotFound as exc:
print(f"Anime not found: {exc}")
# Browse recent reviews.
for review in client.reviews.list(limit=3):
print(review.title, review.rating, review.reviewer)
print("exercised: animesummaries.list / details / releases.list / articles.list / reviews.list")
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.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of news articles to return. |
{
"type": "object",
"fields": {
"news": "array of news article objects with title, url, publication_date, author, and content"
},
"sample": {
"data": {
"news": [
{
"url": "https://www.animenewsnetwork.com/news/2026-06-11/g2-red-aura-webtoon-gets-english-release/.238403",
"title": "G2's Red Aura Webtoon Gets English Release",
"author": "Wonhee Cho",
"content": "Image courtesy of G2...",
"publication_date": "Thu, 11 Jun 2026 06:30:00 -0400"
}
]
},
"status": "success"
}
}About the Anime News Network API
News and Reviews
get_recent_news returns an array of article objects, each with title, url, publication_date, author, and a content snippet. The optional limit parameter controls how many articles come back. get_reviews follows the same shape, adding a reviewer field and a rating value alongside the review text. Both endpoints reflect editorial content published by ANN staff.
Encyclopedia Ratings and Rankings
get_top_anime pulls from ANN's Bayesian rating report and returns each entry's anime_id, title, nb_votes, nb_seen, average, weighted_average, and bayesian_average. This gives you three distinct scoring signals in one response, which is useful when building ranking or recommendation logic that needs to distinguish raw average from vote-weighted scores.
Series Details and Release Schedule
get_anime_details accepts either an anime_id (the numeric ANN encyclopedia ID, e.g. 10216 for Fullmetal Alchemist: Brotherhood) or a free-text query string. The response object includes id, name, type, a ratings block with nb_votes, weighted_score, and bayesian_score, an episodes array of {number, title} objects, plus genres, themes, and a plot summary. get_release_schedule returns upcoming TV anime with id, title, and release_date in YYYY-MM-DD format, making it straightforward to build a premiere calendar.
The Anime News Network API is a managed, monitored endpoint for animenewsnetwork.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when animenewsnetwork.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 animenewsnetwork.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 premiere calendar using
release_datefields fromget_release_schedule - Rank series by
bayesian_averageandnb_votesfor a recommendation engine usingget_top_anime - Display episode-by-episode metadata for a series detail page using the
episodesarray fromget_anime_details - Aggregate ANN review scores by genre to surface critic consensus using
get_reviewsrating data - Feed a news aggregator with timestamped anime industry headlines via
get_recent_news - Cross-reference a series'
weighted_scorewith external ratings by matching on the ANNanime_id - Monitor upcoming premieres and auto-notify users when a tracked title appears in
get_release_schedule
| 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 News Network have an official developer API?+
What rating fields does `get_top_anime` return, and how do they differ?+
get_top_anime returns three numeric rating fields per entry: average (raw mean of all submitted scores), weighted_average (mean adjusted for vote distribution), and bayesian_average (a Bayesian estimate that pulls low-vote titles toward a prior mean, reducing inflation from small sample sizes). nb_votes and nb_seen are also included so you can filter by audience size.Can I look up manga or light novel details the way I can look up anime?+
get_anime_details is scoped to anime series in the ANN encyclopedia and returns fields like episodes, type, and anime-specific ratings. Manga and light novel encyclopedia entries are not covered by the current endpoint set. You can fork this API on Parse and revise it to add a dedicated manga or novel details endpoint.Does `get_anime_details` return character or staff information?+
id, name, type, ratings, episodes, genres, themes, and a plot summary. Cast and staff credits are not included in the current response shape. You can fork this API on Parse and revise it to add character and staff fields.How current is the data returned by `get_recent_news`?+
get_recent_news pulls from ANN's RSS feed, so freshness depends on how frequently that feed is updated by ANN. Articles appear in the feed shortly after publication. There is no date-range filter parameter; use the limit input to control the number of articles returned and process publication_date in your application for any time-based filtering.