Skip to content

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:

EncabezadoDescripción
x-rate-limit-limitDuración de la ventana del límite de tasa actual (ej. 1m)
x-rate-limit-remainingPeticiones restantes en la ventana actual
x-rate-limit-resetMarca de tiempo ISO 8601 de cuándo se reinicia la ventana actual

Límites

EndpointLímite
/search7 peticiones por 5 segundos
/:category200 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, bot o el valor de ejemplo anterior.
  • Sin valores predeterminados de librería: Evita usar cadenas predeterminadas de librerías como python-requests, okhttp, axios, node o Go-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 Googlebot o Bingbot.

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

husbandokitsunenekowaifu

GIFs

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

Campos de Respuesta

TipoCampos
Imágenesartist_name, artist_href, source_url
GIFsanime_name

url y dimensions están incluidos en ambos.