Anime GIF API - Explorer & Docs

Create requests to /gifs, see the URL, the code (Python & cURL) and the answer. Learn the rules & examples below. If everything is empty, we call /gifs? for a random GIF.

Ownership & Blacklist

Everyone can get and create GIFs. You can edit and delete your own GIFs. Admins can manage all GIFs and add users to the blacklist.

Query Builder

Your deployed instance. No / needed at the end.
 false|true|only
Default is false.
With list=tags you get a list of all avaiable tags.
If this is set, don't use tag/anime/character.
Dropdown loads with GET /gifs?list=tags.
Exact Match (case-insensitive).
Exact Match (case-insensitive).
The max amount of results.
Start position (pagination).
/gifs?
Python (requests)
cURL

          

            
          

        

      


      
      

        
Answer

        
-


        

        

        

          
          
        


        
-

      


      
      

        
History (local)

        

          Last few requests. Click to load them again.
        

        

        

          
        

      


      
      

        
API-Documentation


        

          
            Rules & Behaviour
          
          
    
            
  • 
              q (title search) is exclusive:
              Either q or exactly one of
              tag/anime/character.
            
    • 
            
  • 
              nsfw ? {false,
              true, only} - Default:
              false.
            
    • 
            
  • 
              A request without any filter (/gifs?) returns a
              random GIF with the NSFW filter depending on nsfw.
            
    • 
            
  • 
              limit &
              offset are used for pagination (only
              useful for title search).
            
    • 
            
  • 
              list=tags returns all tags (ignores other filters).
            
    • 
          

        


        

          

            
              

                Parameter
                Type
                Example
                Description
              

            
            
              

                q
                string
                q=Nazuna Nanakusa
                
                  Searches the title; do not combine with
                  tag/anime/character.
                
              

              

                tag
                string
                tag=smoking
                
                  Random GIF with the selected tag.
                
              

              

                anime
                string
                anime=Call of the Night
                Random GIF of this anime.
              

              

                character
                string
                character=Nazuna Nanakusa
                
                  Random GIF with the selected character.
                
              

              

                list
                string
                list=tags
                List of all tags.
              

              

                nsfw
                enum
                nsfw=false
                
                  false=only SFW, true=both,
                  only=only NSFW.
                
              

              

                limit
                int
                limit=20
                
                  Max results (1-200) for title search.
                
              

              

                offset
                int
                offset=20
                
                  Start position (pagination) for title search.
                
              

            
          

        


        

          Hint: For typos in anime/character
          the API returns meaningful suggestions in the error object (HTTP 404,
          field
          suggestions).