Get upcoming season anime
get_upcoming_seasonRead-only
List anime scheduled for the upcoming season. Supports filtering by media type, content rating, and pagination.
Instructions
List anime scheduled for the upcoming season. Use get_seasonal_anime for the current or a specific past season. If Tenrai is unavailable and MAL_CLIENT_ID is set, transparently retries via the official API — filter/rating/unapproved/continuing/kids/order_by/sort are silently dropped (no equivalent there), themes/demographics/broadcast come back empty, an explicit sfw: true is enforced client-side (a filtered page can come back shorter than limit), and sfw_strict degrades to the same filtering as sfw there (no Ecchi-genre distinction available).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sfw | No | If true, exclude adult/explicit-rated entries (R+ Mild Nudity and up). Defaults to false (no filtering). Note: this alone still allows mainstream, safely-rated shows tagged with the Ecchi genre (fanservice) through — use `sfw_strict` to also exclude those. | |
| kids | No | If true, exclude entries tagged as children's/kids content. Defaults to false. | |
| page | No | 1-based page number for pagination (1-1000). | |
| sort | No | Sort direction. | |
| limit | No | Max results per page (1-50). | |
| filter | No | Restrict to one or more media types. | |
| rating | No | Restrict to one or more specific content ratings. More granular than `sfw`/`sfw_strict` — use this to target a precise rating band instead of a blanket adult-content cutoff. | |
| order_by | No | Field to order by. Defaults to members. | |
| continuing | No | If true, also include TV series continuing from a previous season. Defaults to false. | |
| sfw_strict | No | If true, exclude adult/explicit-rated entries AND anything tagged with the Ecchi genre, even otherwise-mainstream/safely-rated shows. Stricter than `sfw` alone. Defaults to false. | |
| unapproved | No | If true, also include entries not yet approved by MAL's moderators (excluded by default). Defaults to false. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| results | Yes |