docsOverview

Animechan API docs

All API endpoints are free to use with a default rate limit of 100 requests a day. Need 1,000 requests per hour? Get Animechan Premium for $5/month.

The Base URL (BASE_URL) for all API endpoint is: https://api.animechan.io/v1

Animechan is a REST API for anime quotes. Every quote comes with the anime it is from and the character who said it, returned as JSON. You can get a random quote, filter by anime or character, page through results, and look up anime details such as episode count and summary.

Quickstart

No signup or API key is needed. Request a random quote:

curl https://api.animechan.io/v1/quotes/random

The response is a Quote object:

{
  "status": "success",
  "data": {
    "content": "Courage is a word of justice. It means the quality of mind that enables one to face apprehension with confidence and resolution. It is not right to use it as an excuse to kill someone.",
    "anime": { "id": 271, "name": "Case Closed", "altName": "Meitantei Conan" },
    "character": { "id": 318, "name": "Ran Mouri" }
  }
}

The same request in JavaScript:

const response = await fetch("https://api.animechan.io/v1/quotes/random")
const { data } = await response.json()
console.log(`${data.content} - ${data.character.name}, ${data.anime.name}`)

And in Python, with only the standard library:

import json
from urllib.request import urlopen
 
with urlopen("https://api.animechan.io/v1/quotes/random") as response:
    data = json.load(response)["data"]
 
print(f'{data["content"]} - {data["character"]["name"]}, {data["anime"]["name"]}')

Endpoints

EndpointReturns
/quotes/randomA random quote
/quotes/random?anime=<name>A random quote from one anime
/quotes/random?character=<name>A random quote from one character
/quotes?anime=<name>Quotes from one anime, paginated
/quotes?character=<name>Quotes from one character, paginated
/anime/<id or name>Details for one anime
/animeThe full anime catalogue

The free tier allows 100 requests a day per IP address. For 1,000 requests an hour, see Authentication.