API anime avec les filtres discover

Trouver des anime avec le genre 16 et la langue originale ja

amodb n'a pas de point de terminaison anime distinct. Les anime sont un filtre sur GET /3/discover/tv et GET /3/discover/movie : with_genres=16 (animation) plus with_original_language=ja. Ajoutez l'id du mot-clé anime, que vous trouvez avec GET /3/search/keyword, pour ne garder que les titres étiquetés anime.

Une limite à connaître : le japonais ne fait pas partie des 14 langues d'interface qu'amodb sert. Les titres et les résumés reviennent dans la langue demandée, ou en anglais. Le titre japonais reste dans original_name pour les séries et dans original_title pour les films.

Ce que vous obtenez :

• Des séries d'anime et des films d'anime avec les mêmes filtres discover.
• Les titres originaux japonais à côté des titres localisés.
• Les listes de saisons et d'épisodes de chaque série choisie.
• Des affiches et des images de fond depuis https://img.amodb.dev/t/p/{size}/{file}.

Les données obtenues

Démarrer en 3 étapes

1. Choisissez une offre sur les tarifs. Toutes les données sont dans chaque offre, seul le débit diffère : 20, 40 ou 120 requêtes par minute.
2. Créez une clé dans le tableau de bord de votre compte.
3. Cherchez une fois l'id du mot-clé, puis appelez discover avec lui et les deux filtres.

Exemple de requête

Le script Python trouve l'id du mot-clé anime, puis liste les séries d'animation japonaises les plus populaires qui portent ce mot-clé. L'appel curl en dessous ignore le mot-clé et liste une seule saison de diffusion par fenêtre de dates.

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"])

Une réponse abrégée pour l'appel Python ci-dessus : 2 des 19 résultats de la page 1, avec des tableaux réduits à 2 éléments.

{
  "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
}

Les filtres qui façonnent une liste d'anime

L'étiquetage par mots-clés est partiel. Si une liste semble courte, retirez with_keywords et gardez les filtres de genre et de langue pour un filet plus large. La liste complète des filtres est sur découverte, et les identifiants de mots-clés sont expliqués sur mots-clés.

Films d'anime et longues séries

Les films utilisent les deux mêmes filtres sur le point de terminaison des films. Cet appel liste les films d'animation japonais bien notés, et vote_count.gte écarte les titres qui n'ont que quelques votes.

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"

Chaque résultat a title, original_title, release_date et poster_path. Les séries très longues sont souvent découpées en plusieurs saisons dans le catalogue. GET /3/tv/{series_id}/episode_groups liste d'autres ordres avec leurs noms et leur nombre d'épisodes quand ils sont connus, mais amodb ne sert pas les groupes eux-mêmes, et number_of_episodes sur la série donne le total. Les appels de saisons sont décrits sur API de séries TV.

Titres et langues

Les anime sont le cas où le titre original compte le plus, donc gardez les deux champs.

GET /3/tv/{series_id}/alternative_titles liste d'autres titres par pays quand ils sont connus. Les 14 langues servies sont listées sur langues.

Comparaison

Tarifs

Une liste d'anime représente quelques appels discover, et les résultats de discover restent 30 minutes dans le cache de périphérie, donc 20 requêtes par minute suffisent à beaucoup d'applications. Les offres sont à 20, 40 ou 120 requêtes par minute avec les mêmes données. Payez 1, 3, 6, 12 ou 24 mois, avec 0, 10, 20, 30 et 40 pour cent de réduction, et sans renouvellement automatique. Il n'y a pas d'offre gratuite. Choisissez une offre sur les tarifs.