Seasonal

Used for querying seasonal data such as trending or seasonal media. This route also inserts media if some of the seasonal media doesn't exist in the database like the search route. Technical details regarding the usage of the seasonal function can be found below. Example code is provided for both JavaScript and Python, along with a response schema.

Rate Limits

The seasonal route has a rate limit of 50 requests per minute unless your API key is whitelisted.

Route Schema (URL)

https://api.anify.tv/seasonal/{type}?fields={fields}

Parameter	Type	Description	Required?	Default
type	string	The type of media to search for. Must be either `anime`, `manga`, or `novel`.	Yes	`""`
fields	string[]	The fields to return in the response. For example, if you want the title and cover image, you would input `title,coverImage`.	No	`[id,title,coverImage,bannerImage,description,genres]`
apikey	string	Whitelisted API key	No	`""`

Request Samples

Please note that the fields parameter cannot be passed like thw type parameter. If provided, it must be passed as a query like shown below.

import axios from "axios";
 
const fields = ["title", "coverImage"];
 
const url = `https://api.anify.tv/seasonal/anime?fields=${fields.join(",")}`; // You can also use the `fields` parameter in the query string like: [title,coverImage]
const data = async () => {
    try {
        const { data } = await axios.get(url);
        return data;
    } catch (err) {
        throw new Error(err.message);
    }
};
 
console.log(data);

Response Schema

MIME Type: application/json
Reason: Occurs when the request was successful.

[
    "trending": [{
        "id": "string",
        "slug": "string",
        "coverImage": "string",
        "bannerImage": "string",
        "trailer": "string | null",
        "status": "FINISHED | RELEASING | NOT_YET_RELEASED | CANCELLED | HIATUS",
        "season": "SUMMER | FALL | WINTER | SPRING",
        "title": {
            "native": "string | null",
            "romaji": "string | null",
            "english": "string | null"
        },
        "currentEpisode": "number | null",
        "mappings": [
            {
                "id": "string",
                "providerId": "string",
                "similarity": "number",
                "providerType": "ANIME | MANGA | META | INFORMATION"
            },
        ],
        "synonyms": ["string"],
        "countryOfOrigin": "string",
        "description": "string",
        "duration": "number | null",
        "color": "string | null",
        "year": "number | null",
        "rating": {
            "mal": "number | null",
            "tvdb": "number | null",
            "kitsu": "number | null",
            "anilist": "number | null",
            "anidb": "number | null",
            "tmdb": "number | null",
            "comick": "number | null",
            "mangadex": "number | null",
            "novelupdates": "number | null"
        },
        "popularity": {
            "mal": "number | null",
            "tvdb": "number | null",
            "kitsu": "number | null",
            "anilist": "number | null",
            "anidb": "number | null",
            "tmdb": "number | null",
            "comick": "number | null",
            "mangadex": "number | null",
            "novelupdates": "number | null"
        },
        "type": "ANIME | MANGA",
        "format": "TV | TV_SHORT | MOVIE | SPECIAL | OVA | ONA | MUSIC | MANGA | NOVEL | ONE_SHOT | UNKNOWN",
        "relations": [
            {
                "id": "number",
                "data": {
                    "id": "number",
                    "type": "ANIME | MANGA",
                    "title": {
                        "userPreferred": "string"
                    },
                    "format": "TV | TV_SHORT | MOVIE | SPECIAL | OVA | ONA | MUSIC | MANGA | NOVEL | ONE_SHOT | UNKNOWN",
                    "status": "FINISHED | RELEASING | NOT_YET_RELEASED | CANCELLED | HIATUS",
                    "coverImage": {
                        "large": "string"
                    },
                    "bannerImage": "string | null"
                },
                "type": "ADAPTATION | PREQUEL | SEQUEL | PARENT | SIDE_STORY | CHARACTER | SUMMARY | ALTERNATIVE | SPIN_OFF | OTHER | SOURCE | COMPILATION | CONTAINS"
            },
        ],
        "characters": [
            {
                "name": "string",
                "image": "string",
                "voiceActor": {
                    "name": "string",
                    "image": "string"
                }
            }
        ],
        "totalEpisodes": "number | null",
        "totalVolumes": "number | null",
        "totalChapters": "number | null",
        "genres": ["string"],
        "tags": ["string"],
        "episodes": {
            "latest": {
                "updatedAt": "number",
                "latestTitle": "string",
                "latestEpisode": "number"
            },
            "data": [{
                "episodes": [
                    {
                        "id": "string",
                        "img": "string | null",
                        "title": "string",
                        "hasDub": "boolean",
                        "description": "string | null",
                        "rating": "number | null",
                        "number": "number",
                        "isFiller": "boolean",
                        "updatedAt": "number"
                    }
                ],
                "providerId": "string"
            }]
        },
        "chapters": {
            "latest": {
                "updatedAt": "number",
                "latestTitle": "string",
                "latestChapter": "number"
            },
            "data": [{
                "chapters": [
                    {
                        "id": "string",
                        "title": "string",
                        "number": "number",
                        "rating": "number | null",
                        "updatedAt": "number",
                        "mixdrop": "string | null"
                    }
                ],
                "providerId": "string"
            }]
        },
        "averageRating": "number",
        "averagePopularity": "number",
        "artwork": [
            {
                "img": "string",
                "type": "banner | poster | clear_logo | top_banner",
                "providerId": "string"
            }
        ]
    }],
    "popular": [
        ...
    ],
    "top": [
        ...
    ],
    "seasonal": [
        ...
    ]
]

Searching (Advanced)Schedule