# API de anime con filtros de discover > amodb no tiene un endpoint de anime aparte. Lista anime con /3/discover/tv o /3/discover/movie usando el género 16 y with_original_language=ja, y afínalo con el id de la palabra clave anime de /3/search/keyword. El japonés no es un idioma de interfaz disponible, pero original_name conserva el título japonés. ## 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 | Necesitas | Llamada o campo | Notas | | ------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------ | | Series de anime | `GET /3/discover/tv` con `with_genres=16` y `with_original_language=ja` | `results` incluye `name`, `original_name`, `first_air_date`, `genre_ids` | | Películas de anime | `GET /3/discover/movie` con los mismos dos filtros | `title`, `original_title`, `release_date` | | El id de la palabra clave anime | `GET /3/search/keyword?query=anime` | Array `results` con `id` y `name` | | Lista de episodios | `GET /3/tv/{series_id}/season/{season_number}` | Una llamada por temporada | | Título japonés | `original_name` u `original_title` | Escritura original, tal como se guarda | | Póster | `poster_path` | Añádelo al host de imágenes, sin clave | ## Empieza en 3 pasos 1. Elige un plan en [precios](https://amodb.dev/es/pricing/). 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. ```bash 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" ``` ```python 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. ```json { "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 | Filtro | Valor | Efecto | | ------------------------------------------ | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | `with_genres` | `16` | Animación. Una coma significa AND, así que `16,35` es animación y comedia. | | `without_genres` | id de género | Descarta los títulos que tienen ese género. | | `with_original_language` | `ja` | Solo originales japoneses. | | `with_keywords` | id de palabra clave | Solo los títulos etiquetados con la palabra clave. Se pierden los títulos sin la etiqueta. | | `first_air_date.gte`, `first_air_date.lte` | `YYYY-MM-DD` | Una ventana de emisión para series. Las películas usan `primary_release_date.gte` y `.lte`. | | `sort_by` | `popularity.desc`, `vote_average.desc`, `first_air_date.desc` | Orden. Combina `vote_average.desc` con `vote_count.gte` para que las muestras diminutas no queden primero. | | `page` | 1 a 500 | Hasta 20 resultados por página. | 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](https://amodb.dev/es/discover/), y los ids de palabras clave se explican en [palabras clave](https://amodb.dev/es/keywords/). ## 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. ```bash 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](https://amodb.dev/es/tv-show-api/). ## Títulos e idiomas El anime es el caso en el que más importa el título original, así que conserva ambos campos. | Campo | Contiene | Uso | | ------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------------- | | `name` | Título en el idioma que solicitaste | Etiqueta principal en tu interfaz | | `original_name` | Título en el idioma original, escritura japonesa para los originales japoneses | Etiqueta secundaria, útil para fans que conocen el título japonés | | `original_language` | `ja` | Filtra de tu lado si mezclas fuentes | | `overview` | Texto localizado, vacío cuando no existe traducción | Vuelve a solicitar con `language=en-US` cuando esté vacío | `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](https://amodb.dev/es/languages/). ## Cómo se compara | Capacidad | Hacer scraping de sitios de fans | API de base de datos solo de anime | amodb | | ------------------------------- | -------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------- | | Alcance | Lo que cubra el sitio | Solo anime, revisa la documentación para ver la profundidad | Películas y TV en un solo catálogo, anime elegido con filtros | | Selección de anime | Categorías del sitio | Revisa la documentación | Género 16, `with_original_language=ja`, palabra clave anime | | Título en el idioma original | Varía | Revisa la documentación | `original_name` y `original_title` | | Listas de episodios | Extraídas de las páginas | Revisa la documentación | Llamada de temporada con un array `episodes` | | Japonés como idioma de interfaz | Depende del sitio | Revisa la documentación | No disponible, solo títulos originales | | Condiciones de acceso | Los términos de cada sitio | Los niveles gratuito y de pago varían | De pago, prepago, sin nivel gratuito | ## 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](https://amodb.dev/es/pricing/). ## Preguntas y respuestas ### ¿amodb tiene un endpoint dedicado al anime? No. El anime es un filtro de los endpoints normales de discover: with_genres=16 para Animación y with_original_language=ja para originales japoneses. Añade el id de la palabra clave anime para obtener una lista más ajustada. ### ¿Puedo obtener títulos y sinopsis en japonés? Los originales japoneses conservan su título japonés en original_name para series y en original_title para películas. El japonés no es uno de los 14 idiomas de interfaz disponibles, así que name y overview siguen tu etiqueta de idioma o el inglés. ### ¿Cómo encuentro el id de la palabra clave anime? Llama a /3/search/keyword?query=anime y lee el id del resultado llamado anime. Pásalo como with_keywords en discover. Guarda el id después de la primera consulta, porque las búsquedas de palabras clave se guardan en caché solo 10 minutos. ### ¿El género 16 devuelve solo anime? No. El género 16 es Animación, que también incluye dibujos animados de otros países. Añadir with_original_language=ja elimina la mayoría, y la palabra clave anime afina aún más la lista. ### ¿Hasta qué profundidad puedo paginar una lista de anime? Las páginas van de 1 a 500 con hasta 20 resultados cada una, así que una consulta llega a unos 10,000 resultados. Divide las listas más grandes en ventanas de first_air_date.gte y first_air_date.lte. Los resultados de discover se guardan en caché 30 minutos. ## Páginas relacionadas - [API Discover](https://amodb.dev/es/discover/): API Discover con los mismos filtros que TMDB v3. Lista películas y series por género, reparto, productora, palabra clave, año, nota, duración y plataforma. - [API de palabras clave](https://amodb.dev/es/keywords/): API de palabras clave con rutas TMDB v3: lista las etiquetas de trama de una película o serie, consulta una palabra clave y combina ids con with_keywords. - [Géneros y listas de consulta](https://amodb.dev/es/genres/): API de géneros con rutas TMDB v3: ids de género de películas y TV con nombres traducidos, más listas de países, idiomas, oficios, clasificaciones y proveedores. - [Idiomas](https://amodb.dev/es/languages/): amodb sirve títulos, sinopsis y nombres en 14 idiomas. Pasa una etiqueta estilo TMDB como ru-RU o pt-BR en language; cualquier otra etiqueta recurre al inglés. - [API de series de TV para temporadas y episodios](https://amodb.dev/es/tv-show-api/): API de series de TV con estado, cadenas, temporadas, episodios y next_episode_to_air. JSON de TMDB v3 en 14 idiomas, desde 20 solicitudes por minuto. - [Inicio rápido](https://amodb.dev/es/quickstart/): Haz tu primera llamada a amodb: consigue una clave, pide los detalles de una película en curl, JavaScript, Python, PHP o Go y carga el póster. En 2 minutos. Actualizado: 2026-10-18. Source: https://amodb.dev/es/anime-api/