API de anime con filtros de discover

Encuentra anime con el género 16 y el idioma original ja

amodb no tiene un endpoint de anime aparte. El anime es un filtro de GET /3/discover/tv y GET /3/discover/movie: with_genres=16 (Animación) más with_original_language=ja. Añade el id de la palabra clave anime, que consultas con GET /3/search/keyword, para conservar solo los títulos etiquetados como anime.

Un límite que conviene decir con franqueza: el japonés no es uno de los 14 idiomas de interfaz que sirve amodb. Los títulos y las sinopsis llegan en el idioma que solicitas, o en inglés. El título japonés se queda en original_name para series y en original_title para películas.

Lo que obtienes:

• Series de anime y películas de anime con los mismos filtros de discover.
• Títulos originales en japonés junto a los localizados.
• Listas de temporadas y episodios de cada serie que elijas.
• Pósteres e imágenes de fondo (backdrop) desde https://img.amodb.dev/t/p/{size}/{file}.

Qué datos obtienes

Empieza en 3 pasos

1. Elige un plan en precios. Todos los datos están en cada plan, solo cambia el límite: 20, 40 o 120 solicitudes por minuto.
2. Crea una clave en el panel de tu cuenta.
3. Consulta el id de la palabra clave una sola vez y luego llama a discover con él y con los dos filtros.

Ejemplo de solicitud

El script de Python busca el id de la palabra clave anime y luego lista las series animadas japonesas más populares etiquetadas con ella. La llamada con curl que viene después omite la palabra clave y lista una sola temporada de emisión mediante una ventana de fechas.

curl -s "https://api.amodb.dev/3/discover/tv?with_genres=16&with_original_language=ja&first_air_date.gte=2026-10-01&first_air_date.lte=2026-12-31&sort_by=popularity.desc" \
  -H "Authorization: Bearer $AMODB_KEY"

import os
import requests

BASE = "https://api.amodb.dev/3"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['AMODB_KEY']}"


def get(path, **params):
    r = session.get(BASE + path, params=params, timeout=10)
    r.raise_for_status()
    return r.json()


keywords = get("/search/keyword", query="anime")["results"]
anime_id = next((k["id"] for k in keywords if k["name"].lower() == "anime"), None)
if anime_id is None:
    raise SystemExit("anime keyword not found")

page = get(
    "/discover/tv",
    with_genres=16,
    with_original_language="ja",
    with_keywords=anime_id,
    sort_by="popularity.desc",
    language="en-US",
    page=1,
)
for show in page["results"]:
    print(show.get("first_air_date"), show["name"], "/", show["original_name"])

Una respuesta recortada de la llamada de Python anterior: 2 de los 19 resultados de la página 1, con los arrays reducidos a 2 elementos.

{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/dmptwhmqxcMrCKgyvBlTt18PgDu.jpg",
      "first_air_date": "2005-04-22",
      "genre_ids": [
        10759,
        16
      ],
      "id": 65733,
      "name": "Doraemon",
      "origin_country": [
        "JP"
      ],
      "original_language": "ja",
      "original_name": "ドラえもん",
      "overview": "Robotic cat Doraemon is sent back in time from the 22nd century to protect 10-year-old...",
      "popularity": 301.2214,
      "poster_path": "/9ZN1P32SHviL3SV51qLivxycvcx.jpg",
      "vote_average": 8.089,
      "vote_count": 252
    },
    {
      "adult": false,
      "backdrop_path": "/mFKys64gbDQrFqwUheGwXQwo2JK.jpg",
      "first_air_date": "2004-10-05",
      "genre_ids": [
        10759,
        16
      ],
      "id": 30984,
      "name": "Bleach",
      "origin_country": [
        "JP"
      ],
      "original_language": "ja",
      "original_name": "BLEACH",
      "overview": "For as long as he can remember, Ichigo Kurosaki has been able to see ghosts. But when h...",
      "popularity": 190.3257,
      "poster_path": "/2EewmxXe72ogD0EaWM8gqa0ccIw.jpg",
      "vote_average": 8.4,
      "vote_count": 2295
    }
  ],
  "total_pages": 216,
  "total_results": 4302
}

Filtros que dan forma a una lista de anime

El etiquetado por palabras clave es parcial. Si una lista parece corta, quita with_keywords y conserva los filtros de género e idioma para ampliar el alcance. La lista completa de filtros está en discover, y los ids de palabras clave se explican en palabras clave.

Películas de anime y series largas

Las películas usan los mismos dos filtros en el endpoint de películas. Esta llamada lista películas japonesas animadas con buena valoración, y vote_count.gte deja fuera los títulos con un puñado de votos.

curl -s "https://api.amodb.dev/3/discover/movie?with_genres=16&with_original_language=ja&sort_by=vote_average.desc&vote_count.gte=200" \
  -H "Authorization: Bearer $AMODB_KEY"

Cada resultado tiene title, original_title, release_date y poster_path. Las series de larga duración suelen dividirse en varias temporadas en el catálogo. GET /3/tv/{series_id}/episode_groups lista otros órdenes con sus nombres y su número de episodios cuando se conocen, pero amodb no sirve los grupos en sí, y number_of_episodes en la serie da el total. Las llamadas de temporada se describen en API de series de TV.

Títulos e idiomas

El anime es el caso en el que más importa el título original, así que conserva ambos campos.

GET /3/tv/{series_id}/alternative_titles lista otros títulos por país cuando se conocen. Los 14 idiomas disponibles están en idiomas.

Cómo se compara

Precios

Una lista de anime son unas pocas llamadas a discover, y los resultados de discover permanecen 30 minutos en la caché perimetral, así que 20 solicitudes por minuto bastan para muchas apps. Los planes son de 20, 40 o 120 solicitudes por minuto con los mismos datos. Paga por 1, 3, 6, 12 o 24 meses, con 0, 10, 20, 30 y 40 por ciento de descuento y sin renovación automática. No hay nivel gratuito. Elige un plan en precios.