Документация API

Интегрируйте поиск скриншотов аниме в свое приложение с помощью публичного API.

Бесплатная квота

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

Примечания по аутентификации

Сессионные эндпоинты требуют действительной сессионной cookie better-auth. При вызове с сервера или небраузерных клиентов включайте заголовок Origin (например, Origin: https://your-domain.com) и сохраняйте cookie, возвращаемый /api/auth/sign-in/email.

POST/api/anime/search
Найдите сцену аниме, загрузив файл изображения или указав URL изображения. Возвращает до 5 совпадений с временными метками и оценками схожести.
Аутентификация: Session или API key

Параметры

ИмяТипОбязательноОписание
imageFileНетФайл изображения (JPEG/PNG)
urlstringНетПубличный 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
Получите рейтинг самых популярных аниме за период.
Аутентификация: Нет

Параметры

ИмяТипОбязательноОписание
periodstringНетdaily | weekly | monthly | yearly | all (по умолчанию: all)
limitnumberНетМакс. результатов (по умолчанию: 50)
includeAdultbooleanНетВключить NSFW-записи (по умолчанию: false)

Аутентификация не требуется.

Example

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"
GET/api/anime/recent-searches
Получите недавно подтверждённые публичные поиски.
Аутентификация: Нет

Параметры

ИмяТипОбязательноОписание
limitnumberНетМакс. результатов
offsetnumberНетСмещение пагинации

Публичный эндпоинт.

Example

curl "https://whatanimeisthis.com/api/anime/recent-searches?limit=5"
GET/api/user/anime-credits
Получите оставшиеся кредиты на поиск аниме текущего пользователя.
Аутентификация: Session

Только авторизованные пользователи.

Example

curl "https://whatanimeisthis.com/api/user/anime-credits" \
  -H "Cookie: <SESSION_COOKIE>"
GET/api/apikeys
Получите список ваших API-ключей.
Аутентификация: Session

Параметры

ИмяТипОбязательноОписание
pagenumberНетНомер страницы
pageSizenumberНетЭлементов на странице

Только авторизованные пользователи.

Example

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"
POST/api/apikeys
Создайте новый API-ключ. Текстовый ключ возвращается только один раз.
Аутентификация: Session

Параметры

ИмяТипОбязательноОписание
titlestringДаОписательное имя для ключа

Только авторизованные пользователи.

Example

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