API publica

API DondeAnime

Consulta catalogo, plataformas, generos y temporadas con endpoints versionados en /api/v1.

Versionado estable

Los endpoints publicos viven bajo /api/v1 y los cambios incompatibles se anuncian antes de mover version.

API key obligatoria

Cada request usa el header X-API-Key. El plan free tiene 1000 requests al mes.

Docs interactivas

Swagger UI permite revisar rutas, parametros y respuestas reales de la API publica.

Conseguir una key

Escribe a contacto@dondeanime.com con tu email, caso de uso y volumen estimado.

Diego crea la key desde el panel admin y asigna tier FREE o PAID.

La respuesta incluye la key y el limite mensual. No la expongas en repos publicos ni apps cliente sin proxy.

Ejemplo curl

API_URL="https://api.dondeanime.com"

curl -H "X-API-Key: da_free_tu_key" \
  "$API_URL/api/v1/anime"

Ejemplo JavaScript

const apiUrl =
  "https://api.dondeanime.com";
const path = "/api/v1/anime";

const response = await fetch(apiUrl + path, {
  headers: {
    "X-API-Key": "da_free_tu_key",
  },
});

const anime = await response.json();

Endpoints principales

Metodo	Ruta	Uso
GET	/api/v1/anime	Catalogo publico de anime.
GET	/api/v1/anime/{slug}	Detalle y providers agrupados por pais.
GET	/api/v1/providers	Plataformas con conteos globales o por pais.
GET	/api/v1/genres	Generos disponibles y paginas por genero.
GET	/api/v1/seasons	Temporadas y estrenos por anio.