🔌 AniDeck API

Free REST API. No auth required. Fair use limits apply.

https://anideck.app

Rate Limits

5/day

Roast

50/day

Watch

15/day

Debate

10/day

Tier List

Limits are per IP per day. Cached results don't count toward limits.

POST/api/roast

Roast a MAL or AniList profile

Parameters

usernamestringrequiredMAL or AniList username

platform"mal" | "anilist"optionalDefault: mal

Example

curl -X POST https://anideck.app/api/roast \
  -H "Content-Type: application/json" \
  -d '{"username":"YourMALUser","platform":"mal"}'

POST/api/roast/quick

Roast a custom list without account

Parameters

animeArray<{title, rating}>required3–10 anime with ratings 1–10

hot_takestringoptionalOptional controversial opinion

Example

curl -X POST https://anideck.app/api/roast/quick \
  -H "Content-Type: application/json" \
  -d '{"anime":[{"title":"Naruto","rating":9},{"title":"SAO","rating":4}]}'

GET/api/watch?title=:title

Get AI verdict for an anime

Parameters

titlestringrequiredAnime title to evaluate

Example

curl "https://anideck.app/api/watch?title=Fullmetal+Alchemist+Brotherhood"

POST/api/compatibility

Compare anime taste between two users

Parameters

userA{username, platform}requiredFirst user

userB{username, platform}requiredSecond user

Example

curl -X POST https://anideck.app/api/compatibility \
  -H "Content-Type: application/json" \
  -d '{"userA":{"username":"Alice","platform":"mal"},"userB":{"username":"Bob","platform":"mal"}}'

POST/api/watchorder

Get watch order guide for an anime franchise

Parameters

franchisestringrequiredFranchise name (e.g. Fate, Monogatari)

Example

curl -X POST https://anideck.app/api/watchorder \
  -H "Content-Type: application/json" \
  -d '{"franchise":"Monogatari"}'

POST/api/continue

Should you continue a dropped anime?

Parameters

titlestringrequiredAnime title

dropped_atstringoptionalWhere you dropped it

Example

curl -X POST https://anideck.app/api/continue \
  -H "Content-Type: application/json" \
  -d '{"title":"Bleach","dropped_at":"Bount arc"}'

POST/api/debate

Debate any anime hot take

Parameters

opinionstringrequiredMax 200 chars

Example

curl -X POST https://anideck.app/api/debate \
  -H "Content-Type: application/json" \
  -d '{"opinion":"SAO is actually good"}'

GET/api/verse

Daily anime quote

Example

curl "https://anideck.app/api/verse"

GET/api/season

Seasonal anime watchlist

Parameters

seasonstringoptionalWinter/Spring/Summer/Fall

yearnumberoptionalYear (default: current)

Example

curl "https://anideck.app/api/season?season=Fall&year=2025"

POST/api/tier

Generate an anime tier list

Parameters

categorystringrequiredWhat to tier (e.g. Shonen anime)

Example

curl -X POST https://anideck.app/api/tier \
  -H "Content-Type: application/json" \
  -d '{"category":"Isekai anime"}'

Building something cool?

Tag us on social or open a GitHub issue — we'd love to see what you build.