🚧 The Consumet documentation is undergoing reconstruction. Please be patient for all providers to be fully-documented. 🚧
API
Meta
Anilist (Anime)
Advanced Search

Search

Technical details regarding the usage of the search function for the anilist provider can be found below. Example code is provided for both JavaScript and Python, along with a response schema.

Route Schema (URL)

https://api.consumet.org/meta/anilist/advanced-search

Query Parameters

ParameterTypeDescriptionRequired?Default
querystringThe search query; i.e. the title of the item you are looking for.No""
typestringThe type of entertainment. Enum: "ANIME" "MANGA"No"ANIME"
pageintegerThe page number of results to return.No1
perPageintegerThe number of items perpage of results to return.No20
seasonstringThe season the anime aired in. Enum: "WINTER" "SPRING" "SUMMER" "FALL"No""
formatstringThe fromat of the anime. Enum: "TV" "TV_SHORT" "OVA" "ONA" "MOVIE" "SPECIAL" "MUSIC"No""
sortarraythe items you want to sort by. Array Enum: "POPULARITY_DESC" "POPULARITY" "TRENDING_DESC" "TRENDING" "UPDATED_AT_DESC" "UPDATED_AT" "START_DATE_DESC" "START_DATE" "END_DATE_DESC" "END_DATE" "FAVOURITES_DESC" "FAVOURITES" "SCORE_DESC" "SCORE" "TITLE_ROMAJI_DESC" "TITLE_ROMAJI" "TITLE_ENGLISH_DESC" "TITLE_ENGLISH" "TITLE_NATIVE_DESC" "TITLE_NATIVE" "EPISODES_DESC" "EPISODES" "ID" "ID_DESC"No["POPULARITY_DESC","SCORE_DESC"]
genresarrayThe genres you want to search for. Array Enum: "Action" "Adventure" "Cars" "Comedy" "Drama" "Fantasy" "Horror" "Mahou Shoujo" "Mecha" "Music" "Mystery" "Psychological" "Romance" "Sci-Fi" "Slice of Life" "Sports" "Supernatural" "Thriller"No""
idstringThe id of the anime you are looking forNo""
yearstringThe year the anime released inNo""
statusstringThe current status of the anime you are looking for Enum: "RELEASING" "NOT_YET_RELEASED" "FINISHED" "CANCELLED" "HIATUS"No""

Request Samples

import axios from "axios";
 
// Using the example query "demon", and looking at the first page of results.
const url = "https://api.consumet.org/meta/anilist/advanced-search";
const data = async () => {
    try {
        const { data } = await axios.get(url, { params: { page: 1 } });
        return data;
    } catch (err) {
        throw new Error(err.message);
    }
};
 
console.log(data);

Response Schema

MIME Type: application/json

{
"currentPage": 1,
"results": [
    {
      "id": "string",
      "title": "string",
      "image": "string",
      "type": "string",
      "rating": "number",
      "releaseDate": "string"
    }
  ]
}