Справочник API

Ограничения запросов (Rate Limits)

Каждый ответ содержит следующие заголовки, помогающие отслеживать и соблюдать ограничения запросов:

Заголовок	Описание
x-rate-limit-limit	Длительность текущего окна ограничений (например, 1m)
x-rate-limit-remaining	Оставшееся количество запросов в текущем окне
x-rate-limit-reset	Временная метка ISO 8601 сброса текущего окна

Лимиты

Эндпоинт	Лимит
/search	7 запросов за 5 секунд
/:category	200 запросов в минуту (для каждой категории)

User-Agent

Все запросы должны содержать заголовок User-Agent. Используйте следующий формат: ИМЯ_ПРИЛОЖЕНИЯ (КОНТАКТНАЯ_ИНФОРМАЦИЯ).
Например: NekoApp (https://example.com) или NekoApp (dev@example.com)

Правила наименования:

• Будьте специфичны: Не используйте общие названия, такие как "Discord Bot", "WhatsApp Bot" или "Telegram Bot". Ваше приложение должно иметь уникальное имя.
• Избегайте плейсхолдеров: Не используйте такие строки, как test, bot или вышеуказанный пример.
• Без стандартных значений библиотек: Избегайте использования стандартных строк библиотек, таких как python-requests, okhttp, axios, node или Go-http-client.

Варианты контактной информации:
Контактная информация не обязательно должна быть традиционным веб-сайтом. Любой из следующих вариантов является приемлемым способом идентификации:

• Прямой адрес электронной почты для связи.
• Веб-сайт проекта или URL публичного репозитория (например, GitHub, GitLab).
• Ссылка на приглашение бота или страницу обнаружения.
• URL-адрес в каталоге (например, top.gg или аналогичных сервисах).

Спуфинг и выдача себя за других:

• Не подделывайте строки браузера. Формат Mozilla/5.0 ... строго зарезервирован для реальных веб-браузеров и ботов, проверенных Cloudflare.
• Не выдавайте себя за известных поисковых роботов, таких как Googlebot или Bingbot.

Несоблюдение этих правил и использование общих, стандартных или поддельных значений приведет к блокировке ваших запросов.

Категории

Категории определяют тип содержимого, возвращаемого API. Каждая категория соответствует фиксированному формату файлов.

Изображения

husbandokitsunenekowaifu

GIF-анимации

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

Поля ответа

Тип	Поля
Изображения	artist_name, artist_href, source_url
GIF-анимации	anime_name

url и dimensions присутствуют в обоих типах.