Interactive API Reference

Live interactive playground to test AniList and MyAnimeList metadata endpoints and filters.

Base URL
Filtering Guide

Can We Use Filters From MAL and AniList?

✨ Yes! Full Multi-Attribute Filtering Supported

Both AniList and MyAnimeList support rich filtering. Here is exactly what each provider supports:

AniList Filters (via GraphQL)

  • Trending: GET /meta/anilist/trending?page=1&perPage=20
  • Popular: GET /meta/anilist/popular?page=1&perPage=20
  • Upcoming: GET /meta/anilist/upcoming?page=1&perPage=20
  • Genres: Pass JSON array e.g. genres=["Action","Fantasy"]
  • Release Year: e.g. year=2024
  • Season: WINTER, SPRING, SUMMER, FALL
  • Format: TV, MOVIE, OVA, ONA, SPECIAL, MUSIC
  • Status: RELEASING, FINISHED, NOT_YET_RELEASED, CANCELLED, HIATUS
  • Sort: ["SCORE_DESC"], ["POPULARITY_DESC"], ["TRENDING_DESC"], ["FAVOURITES_DESC"]

MyAnimeList Filters (via /top)

  • Top Category Filters (GET /meta/mal/top?type={type}&page=1):
    • upcoming - Top Upcoming Anime
    • airing - Currently Airing / Trending Anime
    • tv - Top TV Series
    • movie - Top Anime Movies
    • ova - Top OVAs
    • ona - Top ONAs
    • special - Top Specials
    • bypopularity - Most Popular Anime of All Time
    • favorite - Most Favorited Anime
    • all - Overall Top Rated Anime
  • Quick Shorthand: /meta/mal/trending and /meta/mal/popular
AniList Provider

AniList Endpoints

GET /meta/anilist/upcoming
Upcoming anime sorted by popularity
ParameterTypeValueDescription
page integer Optional Page number
perPage integer Optional Results per page
/meta/anilist/upcoming 

          

        

      


      
      

        

          

            GET
            /meta/anilist/advanced-search
          

          Multi-attribute filtered anime search
        

        

          

            
ParameterTypeValueDescription

            
              

                query
                string
                
                Optional Title search
              

              

                genres
                JSON array
                
                Optional e.g. ["Action","Adventure"]
              

              

                year
                integer
                
                Optional Year
              

              

                season
                string
                
                  
                
                Optional Season
              

              

                format
                string
                
                  
                
                Optional Format
              

              

                sort
                JSON array
                
                Optional Sort criteria
              

            
          

          

            
          

          

            

              
              
            

            

          

        

      


      
      

        

          

            GET
            /meta/anilist/info/:id
          

          Comprehensive details & episode catalog
        

        

          

            
            
            
          

          

            

              
              
            

            

          

        

      


      
      

        

          

            GET
            /meta/anilist/random-anime
          

          Random anime discovery
        

        

          
          

            

              
              
            

            

          

        

      

    


    
    
    
    

      

        MyAnimeList Provider
        
MyAnimeList Endpoints

      


      
      

        

          

            GET
            /meta/mal/top
          

          Category rankings: Upcoming, Airing, TV, Movie, Popular, etc.
        

        

          

            
ParameterTypeValueDescription

            
              

                type
                string
                
                  
                
                Ranking category filter
              

              

                page
                integer
                
                Page number (50 items/page)
              

            
          

          

            
          

          

            

              
              
            

            

          

        

      


      
      

      

      
      

        

          

            GET
            /meta/mal/:query
          

          Search anime titles on MyAnimeList
        

        

          

            
            
            
          

          

            

              
              
            

            

          

        

      


      
      

        

          

            GET
            /meta/mal/info/:id
          

          Detailed metadata by MAL ID