API Documentation

Integrate anime screenshot search into your app with our public API.

Free Quota

Signed-in users: 10 free credits per day (expire at midnight). After that, 1 credit per search. Upgrade for more.

Authentication Notes

Session-based endpoints require a valid better-auth session cookie. When calling from server-side or non-browser clients, include the Origin header (e.g. Origin: https://your-domain.com) and store the session cookie returned by /api/auth/sign-in/email.

POST/api/anime/search

Search for an anime scene by uploading an image file or providing an image URL. Returns up to 5 candidate matches with timestamps and similarity scores.

Authentication: Session or API key

Parameters

Name	Type	Required	Description
image	File	No	Image file (JPEG/PNG)
url	string	No	Public image URL

Guests: 5/day by IP. Signed-in users: 10 daily free credits, then 1 credit per search, 100/hour.

Example

curl -X POST https://whatanimeisthis.com/api/anime/search \
  -F "url=https://example.com/screenshot.png"

curl -X POST https://whatanimeisthis.com/api/anime/search \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "url=https://example.com/screenshot.png"

GET/api/anime/rankings

Fetch the most searched anime rankings by period.

Authentication: None

Parameters

Name	Type	Required	Description
period	string	No	daily \| weekly \| monthly \| yearly \| all (default: all)
limit	number	No	Max results (default: 50)
includeAdult	boolean	No	Include NSFW entries (default: false)

No authentication required.

Example

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"

GET/api/anime/recent-searches

Fetch recently confirmed public searches.

Authentication: None

Parameters

Name	Type	Required	Description
limit	number	No	Max results
offset	number	No	Pagination offset

Public endpoint.

Example

curl "https://whatanimeisthis.com/api/anime/recent-searches?limit=5"

GET/api/user/anime-credits

Get the current signed-in user's remaining anime search credits.

Authentication: Session

Signed-in users only.

Example

curl "https://whatanimeisthis.com/api/user/anime-credits" \
  -H "Cookie: <SESSION_COOKIE>"

GET/api/apikeys

List your API keys.

Authentication: Session

Parameters

Name	Type	Required	Description
page	number	No	Page number
pageSize	number	No	Items per page

Signed-in users only.

Example

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"

POST/api/apikeys

Create a new API key. The plaintext key is returned only once.

Authentication: Session

Parameters

Name	Type	Required	Description
title	string	Yes	Descriptive name for the key

Signed-in users only.

Example

curl -X POST https://whatanimeisthis.com/api/apikeys \
  -H "Content-Type: application/json" \
  -H "Cookie: <SESSION_COOKIE>" \
  -d '{"title":"my-key"}'