API Access

How Not To Get Banned

First: Set a HTTP_USER_AGENT for the tool you will be accessing ACDB from.

Our current whitelist of user agents that will be spared a cookie check includes:

   ~Ladybird/        
   ~^Links           
   ~^Lynx/           
   ~archive\.org_bot  
   ~Mastodon         
   ~^Pleroma         
   ~^tldr-fetcher    
   ~Discordbot/     
   ~Googlebot/      
   ~Google-Read-Aloud 
   ~GoogleOther     
   ~bingbot/        
   ~TikTokSpider    
   ~360Spider       
   ~Baiduspider/    
   ~Applebot/       
   ~QuiteRss/       
   ~^reqwest        
   ~^Python         
   ~^python         
   ~^GuzzleHttp     
   ~^curl           
   ~^Wget           
   ~^http.rb        
   ~^Go-http-client 
   ~^CyotekWebCopy  
   ~^Dart           
   ~^node-fetch     
   ~^fasthttp       
   ~^Scrapy/        
   ~^Dalvik          
   ~^git/            

To safely check your user agent, visit this page:

https://www.animecharactersdatabase.com/vars.php

Second: Rate limit your requests.

Respectfully, limit your bot to 1 request per second.

Current API tools

Current API Tools

Characters

Characters API

Titles

Titles API

Assignments

Assignments API

License

Open Database License - Terms of Legal Use

Changes

January 20th 2021

When requesting birthdays

• character_image now returns the full sized character image
• character_thumb has been added to return the character thumb instead

January 4th 2026

Access to ACDB requires cookies. However some user agents are white listed and will not be subject to a cookie check. Be sure to use a white listed user agent in your request if you are not sending cookies.