Referencia de la API
Límites de Tasa (Rate Limits)
Todas las respuestas incluyen los siguientes encabezados para ayudarle a rastrear y respetar los límites de tasa:
| Encabezado | Descripción |
|---|---|
x-rate-limit-limit | Duración de la ventana del límite de tasa actual (ej. 1m) |
x-rate-limit-remaining | Peticiones restantes en la ventana actual |
x-rate-limit-reset | Marca de tiempo ISO 8601 de cuándo se reinicia la ventana actual |
Límites
| Endpoint | Límite |
|---|---|
/search | 7 peticiones por 5 segundos |
/:category | 200 peticiones por minuto (por categoría) |
User-Agent
Todas las peticiones deben incluir un encabezado User-Agent. Por favor usa el siguiente formato: NOMBRE_APP (INFO_CONTACTO).
Por ejemplo: NekoApp (https://example.com) o NekoApp (dev@example.com)
Pautas de Nombres:
- Sé específico: No uses nombres genéricos como "Discord Bot", "WhatsApp Bot" o "Telegram Bot". Tu aplicación debe tener un nombre único.
- Evita marcadores de posición: No uses cadenas como
test,boto el valor de ejemplo anterior. - Sin valores predeterminados de librería: Evita usar cadenas predeterminadas de librerías como
python-requests,okhttp,axios,nodeoGo-http-client.
Opciones de Información de Contacto:
La información de contacto no tiene que ser un sitio web tradicional. Cualquiera de las siguientes es una forma aceptable de proporcionar identificación:
- Una dirección de correo electrónico de contacto directo.
- Un sitio web del proyecto o una URL de repositorio público (ej. GitHub, GitLab).
- Un enlace de invitación de bot o página de descubrimiento.
- Una URL de lista (ej. top.gg o directorios similares).
Suplantación y Falsificación:
- No falsifiques cadenas de navegador. El formato
Mozilla/5.0 ...está estrictamente reservado para navegadores web reales y bots verificados por Cloudflare. - No suplantes bots de búsqueda conocidos como
GooglebotoBingbot.
El incumplimiento de estas pautas y el uso de valores genéricos, predeterminados o falsificados probablemente resultará en el bloqueo de sus peticiones.
Categorías
Las categorías definen el tipo de contenido devuelto por la API. Cada categoría se asigna a un formato de archivo fijo.
Imágenes
GIFs
Campos de Respuesta
| Tipo | Campos |
|---|---|
| Imágenes | artist_name, artist_href, source_url |
| GIFs | anime_name |
url y dimensions están incluidos en ambos.