Referência da API

Limites de taxa (Rate Limits)

Cada resposta contém os seguintes cabeçalhos para ajudá-lo a rastrear e respeitar os limites de taxa:

Cabeçalho	Descrição
x-rate-limit-limit	Duração da janela atual do limite de taxa (ex.: 1m)
x-rate-limit-remaining	Requisições restantes na janela atual
x-rate-limit-reset	Carimbo de data/hora ISO 8601 de quando a janela atual será redefinida

Limites

Endpoint	Limite
/search	7 requisições a cada 5 segundos
/:category	200 requisições por minuto (por categoria)

User-Agent

Todas as requisições devem incluir um cabeçalho User-Agent. Por favor, use o seguinte formato: NOME_DO_APP (INFO_DE_CONTATO).
Por exemplo: NekoApp (https://example.com) ou NekoApp (dev@example.com)

Diretrizes para nomeação:

• Seja específico: Não use nomes genéricos como "Bot do Discord", "Bot do WhatsApp" ou "Bot do Telegram". Sua aplicação deve ter um nome único.
• Evite marcadores genéricos: Não use strings como test, bot ou o valor de exemplo acima.
• Sem valores padrão de bibliotecas: Evite usar strings padrão de bibliotecas como python-requests, okhttp, axios, node ou Go-http-client.

Opções de informações de contato:
A informação de contato não precisa ser um site tradicional. Qualquer uma das seguintes formas é aceitável para identificação:

• Um endereço de e-mail de contato direto.
• Um site do projeto ou um repositório público (ex.: GitHub, GitLab).
• Um link de convite do bot ou página de descoberta (Discovery).
• Uma URL de listagem (ex.: top.gg ou diretórios semelhantes).

Falsificação e falsidade ideológica (Spoofing & Impersonation):

• Não forje strings de navegador. O formato Mozilla/5.0 ... é estritamente reservado para navegadores web reais e bots verificados pela Cloudflare.
• Não se passe por crawlers conhecidos, como Googlebot ou Bingbot.

O não cumprimento dessas diretrizes, bem como o uso de valores genéricos, padrão ou forjados, muito provavelmente resultará no bloqueio de suas requisições.

Categorias

As categorias definem o tipo de conteúdo retornado pela API. Cada categoria está associada a um formato de arquivo fixo.

Imagens

husbandokitsunenekowaifu

GIFs

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

Campos de resposta

Tipo	Campos
Imagens	artist_name, artist_href, source_url
GIFs	anime_name

url e dimensions estão incluídos em ambos.