API Access

From Anime Characters Database Wiki
Revision as of 20:31, 20 July 2024 by RinaK (talk | contribs) (Added information and changed some wording.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

How Not To Get Banned

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

If Python,Perl,etc is in your user agent, you will get errors like

( 402 Payment Required ) 

If you leave it with the default, you will be joining a pool of people who also left it default, and together may pose a DDoS threat. This is why I auto ban curl/python/wget any any other popular tool.

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