# API anime avec les filtres discover > amodb n'a pas de point de terminaison anime distinct. Listez les anime avec /3/discover/tv ou /3/discover/movie en utilisant le genre 16 et with_original_language=ja, puis affinez avec l'id du mot-clé anime issu de /3/search/keyword. Le japonais n'est pas une langue d'interface servie, mais original_name garde le titre japonais. ## 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 | Besoin | Appel ou champ | Remarques | | --------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------- | | Séries d'anime | `GET /3/discover/tv` avec `with_genres=16` et `with_original_language=ja` | `results` contient `name`, `original_name`, `first_air_date`, `genre_ids` | | Films d'anime | `GET /3/discover/movie` avec les deux mêmes filtres | `title`, `original_title`, `release_date` | | L'id du mot-clé anime | `GET /3/search/keyword?query=anime` | Tableau `results` de `id` et `name` | | Liste d'épisodes | `GET /3/tv/{series_id}/season/{season_number}` | Un appel par saison | | Titre japonais | `original_name` ou `original_title` | Écriture d'origine, telle que stockée | | Affiche | `poster_path` | À ajouter à l'hôte d'images, sans clé | ## Démarrer en 3 étapes 1. Choisissez une offre sur les [tarifs](https://amodb.dev/fr/pricing/). 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. ```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"]) ``` 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. ```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 } ``` ## Les filtres qui façonnent une liste d'anime | Filtre | Valeur | Effet | | ------------------------------------------ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | `with_genres` | `16` | Animation. Une virgule signifie ET, donc `16,35` est animation et comédie. | | `without_genres` | id de genre | Écarte les titres qui portent ce genre. | | `with_original_language` | `ja` | Originaux japonais uniquement. | | `with_keywords` | id de mot-clé | Seulement les titres étiquetés avec ce mot-clé. Les titres sans l'étiquette sont manqués. | | `first_air_date.gte`, `first_air_date.lte` | `YYYY-MM-DD` | Une fenêtre de diffusion pour les séries. Les films utilisent `primary_release_date.gte` et `.lte`. | | `sort_by` | `popularity.desc`, `vote_average.desc`, `first_air_date.desc` | Ordre. Associez `vote_average.desc` à `vote_count.gte` pour que les petits échantillons ne soient pas classés en premier. | | `page` | 1 à 500 | Jusqu'à 20 résultats par page. | 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](https://amodb.dev/fr/discover/), et les identifiants de mots-clés sont expliqués sur [mots-clés](https://amodb.dev/fr/keywords/). ## 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. ```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" ``` 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](https://amodb.dev/fr/tv-show-api/). ## Titres et langues Les anime sont le cas où le titre original compte le plus, donc gardez les deux champs. | Champ | Contient | Usage | | ------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------- | | `name` | Titre dans la langue demandée | Libellé principal dans votre interface | | `original_name` | Titre dans la langue d'origine, écriture japonaise pour les originaux japonais | Libellé secondaire, utile aux fans qui connaissent le titre japonais | | `original_language` | `ja` | Filtre de votre côté si vous mélangez des sources | | `overview` | Texte localisé, vide quand il n'existe pas de traduction | Redemandez avec `language=en-US` quand il est vide | `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](https://amodb.dev/fr/languages/). ## Comparaison | Capacité | Extraire les sites de fans | API de base de données dédiée aux anime | amodb | | ------------------------- | ----------------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------- | | Couverture | Ce que couvre le site | Anime uniquement, voir la documentation pour la profondeur | Films et séries dans un seul catalogue, anime choisis par filtres | | Sélection des anime | Catégories du site | Voir la documentation | Genre 16, `with_original_language=ja`, mot-clé anime | | Titre en langue originale | Variable | Voir la documentation | `original_name` et `original_title` | | Listes d'épisodes | Extraites des pages | Voir la documentation | Appel de saison avec un tableau `episodes` | | Interface en japonais | Selon le site | Voir la documentation | Non servie, titres originaux uniquement | | Conditions d'accès | Les conditions de chaque site | Offres gratuites et payantes variables | Payant, prépayé, sans offre gratuite | ## 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](https://amodb.dev/fr/pricing/). ## Questions et réponses ### amodb a-t-il un point de terminaison anime dédié ? Non. Les anime sont un filtre des points de terminaison discover habituels : with_genres=16 pour l'animation et with_original_language=ja pour les originaux japonais. Ajoutez l'id du mot-clé anime pour une liste plus ciblée. ### Puis-je obtenir les titres et les résumés en japonais ? Les originaux japonais gardent leur titre japonais dans original_name pour les séries et dans original_title pour les films. Le japonais ne fait pas partie des 14 langues d'interface servies, donc name et overview suivent votre balise de langue ou l'anglais. ### Comment trouver l'id du mot-clé anime ? Appelez /3/search/keyword?query=anime et lisez l'id du résultat nommé anime. Passez-le comme with_keywords sur discover. Conservez l'id après la première recherche, car les recherches de mots-clés ne sont mises en cache que 10 minutes. ### Le genre 16 ne renvoie-t-il que des anime ? Non. Le genre 16 est l'animation, qui couvre aussi les dessins animés d'autres pays. Ajouter with_original_language=ja en retire la plupart, et le mot-clé anime resserre encore la liste. ### Jusqu'où puis-je paginer une liste d'anime ? Les pages vont de 1 à 500 avec jusqu'à 20 résultats chacune, donc une requête atteint environ 10 000 résultats. Découpez les listes plus grandes en fenêtres first_air_date.gte et first_air_date.lte. Les résultats de discover sont mis en cache 30 minutes. ## Pages liées - [API Discover](https://amodb.dev/fr/discover/): API Discover avec les mêmes filtres que TMDB v3. Listez films et séries par genre, distribution, société, mot-clé, année, note, durée et plateforme. - [API des mots-clés](https://amodb.dev/fr/keywords/): API mots-clés aux chemins TMDB v3 : tags d'intrigue d'un film ou d'une série, recherche d'un mot-clé, ses films et with_keywords avec discover. - [Genres et listes de référence](https://amodb.dev/fr/genres/): API de genres aux chemins TMDB v3 : identifiants de genres films et séries avec noms traduits, plus pays, langues, métiers, classifications et plateformes. - [Langues](https://amodb.dev/fr/languages/): amodb sert titres, résumés et noms en 14 langues. Passez une balise TMDB comme ru-RU ou pt-BR dans language ; toute autre balise se replie sur l'anglais. - [API de séries TV pour les séries, les saisons et les épisodes](https://amodb.dev/fr/tv-show-api/): API de séries TV avec statut, chaînes, saisons, épisodes et next_episode_to_air. JSON compatible TMDB v3 en 14 langues, dès 20 requêtes par minute. - [Démarrage rapide](https://amodb.dev/fr/quickstart/): Faites votre premier appel amodb : obtenez une clé, demandez un film en curl, JavaScript, Python, PHP ou Go, puis chargez l'affiche. En moins de 2 minutes. Mis à jour: 2026-10-18. Source: https://amodb.dev/fr/anime-api/