AniList API: Get next episode
Finds the most popular anime matching a name on AniList and returns its next scheduled episode with local air time, status, episode count and streaming links.
Unofficial. Not affiliated with or endorsed by AniList.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Anime, required
anime Anime name in English or Japanese, for example One Piece.
One Piece
- Time Zone optional
time_zone City or time zone for the air time, for example London or Europe/London. Defaults to UTC.
London
Default
UTC.
Input as JSON
{ "anime": "One Piece", "time_zone": "London"}Output
{ "title": { "english": "ONE PIECE", "japanese_romaji": "ONE PIECE" }, "status": "Releasing", "anilist_id": 21, "anilist_link": "https://anilist.co/anime/21" , "total_episodes": null, "streaming_links": [ { "link": "http://www.crunchyroll.com/one-piece" , "site_name": "Crunchyroll" }, { "link": "http://www.hulu.com/one-piece" , "site_name": "Hulu" }, { "link": "https://www.netflix.com/title/80107103" , "site_name": "Netflix" } ], "next_air_datetime": "2027-01-03T14:16:00+00:00", "time_until_airing": "72 days 4 hours 47 minutes", "next_episode_number": 1181}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"anilist.co/get_next_episode","input":{"anime":"One Piece","time_zone":"London"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "anilist.co/get_next_episode" , "input": { "anime": "One Piece", "time_zone": "London" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "anilist.co/get_next_episode" , "input": { "anime": "One Piece", "time_zone": "London" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run anilist.co/get_next_episode# with {"anime":"One Piece","time_zone":"London"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "anime" ], "properties": { "anime": { "type": "string", "minLength": 1, "description": "Anime name in English or Japanese, for example One Piece." }, "time_zone": { "type": "string", "default": "UTC", "description": "City or time zone for the air time, for example London or Europe/London. Defaults to UTC." } }}Output schema
{ "type": "object", "required": [ "title", "status", "next_episode_number", "next_air_datetime", "time_until_airing", "total_episodes", "streaming_links", "anilist_link", "anilist_id" ], "properties": { "title": { "type": "object", "required": [ "english", "japanese_romaji" ], "properties": { "english": { "type": [ "string", "null" ], "description": "English anime title, if available." }, "japanese_romaji": { "type": [ "string", "null" ], "description": "Japanese anime title in Latin letters, if available." } }, "additionalProperties": false }, "status": { "type": [ "string", "null" ], "description": "Release status." }, "anilist_id": { "type": "integer", "description": "AniList media identifier.", "x-fous-developer": true }, "anilist_link": { "type": "string", "description": "AniList page for this anime." }, "total_episodes": { "type": [ "integer", "null" ], "description": "Total episode count, if known." }, "streaming_links": { "type": "array", "items": { "type": "object", "required": [ "site_name", "link" ], "properties": { "link": { "type": "string" }, "site_name": { "type": "string" } }, "additionalProperties": false } }, "next_air_datetime": { "type": [ "string", "null" ], "description": "Next air time as ISO 8601 with the chosen time zone offset." }, "time_until_airing": { "type": [ "string", "null" ], "description": "Time remaining until the next episode." }, "next_episode_number": { "type": [ "integer", "null" ], "description": "Number of the next scheduled episode." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
anilist.co/get_next_episode- Returns
- title, status, next episode number and air time, time until airing, total episodes, streaming links, AniList link and id
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method anilist.co/get_next_episode with the inputs above.
Ask your agent
- When does the next episode of Frieren air in Tokyo time?
- What's the next episode date for Jujutsu Kaisen season 2 in New York?
- Show me when the next Chainsaw Man episode airs, converted to Berlin time, plus how many episodes it has in total.
- Find the upcoming airing schedule for Spy x Family with the local time in Sydney and any streaming links.
- Is there a new episode of Oshi no Ko coming out soon, and what time does it air in Los Angeles?
See more
All AniList methodsLists upcoming AniList anime episodes ordered by air time, with air times in the chosen time zone and available streaming links.
anilist.co/get_airing_scheduleLooks up an anime on MyAnimeList by English or Japanese name, or by a MyAnimeList anime link. For ambiguous names it returns the most popular match.
myanimelist.net/get_animeGets a manga, manhwa or light novel from MyAnimeList by title or by MyAnimeList link. When several entries share the top result's title, it returns the most popular one.
myanimelist.net/get_mangaLists MyAnimeList's top anime in rank order for a selected ranking (all, airing, upcoming, TV, movies or most popular), with English title, score, type, episodes, airing dates and members.
myanimelist.net/list_top_animeGets public Crunchyroll series details by series name or series link; matches a series title rather than a movie.
crunchyroll.com/get_seriesLists anime in a MyAnimeList season sorted by members, with scores, episode counts, studio, genres and links. Continuing TV series are optional.
myanimelist.net/list_seasonal_animeLooks up a TV show by name or TVmaze link and returns its status, schedule, rating, next and previous episodes, and optionally the full episode list including specials.
tvmaze.com/get_showFinds a TV show on TMDB by exact name or TMDB show link and returns its details, cast, seasons, the last aired and next scheduled episodes, and the streaming services listed for a chosen country.
themoviedb.org/get_tv_show