# API acteurs > L'API acteurs correspond à la famille people de TMDB v3 sur api.amodb.dev/3. Récupérez une personne avec GET /3/person/{person_id}, ajoutez combined_credits pour la filmographie complète et images pour les photos de profil. Une liste populaire, la recherche par nom et la recherche par identifiant IMDb utilisent la même clé et la même forme JSON. ## Rechercher un acteur et sa filmographie `GET /3/person/{person_id}` renvoie une biographie, des données de naissance et un chemin d'image de profil pour une personne. Ajoutez `append_to_response=combined_credits` et la même réponse contient aussi tous les crédits de films et de séries. Les identifiants sont les identifiants numériques de personnes qu'utilise TMDB, par exemple `31` pour Tom Hanks. Vous obtenez une fiche de personne, une filmographie de distribution et d'équipe, des photos de profil et des listes pour la découverte. Les acteurs, les réalisateurs et les scénaristes vivent dans les mêmes points de terminaison et se distinguent par `known_for_department`. ## Les données obtenues | Point de terminaison | Renvoie | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `GET /3/person/{person_id}` | `name`, `biography`, `birthday`, `deathday`, `place_of_birth`, `known_for_department`, `profile_path`, `imdb_id` | | `GET /3/person/{person_id}/movie_credits` | Les rôles de films dans `cast` et les métiers dans `crew` | | `GET /3/person/{person_id}/tv_credits` | La même chose pour les séries | | `GET /3/person/{person_id}/combined_credits` | Films et séries dans une seule liste, marqués par `media_type` | | `GET /3/person/{person_id}/images` | Un tableau `profiles` de photos | | `GET /3/person/popular` | Liste paginée des personnes populaires | | `GET /3/search/person` | Les personnes qui correspondent à une `query` | ## Démarrer en 3 étapes 1. Choisissez une offre sur les [tarifs](https://amodb.dev/fr/pricing/). Toutes les offres renvoient les mêmes données et ne diffèrent que par le nombre de requêtes par minute. 2. Générez une clé dans le tableau de bord de votre compte. 3. Envoyez `GET /3/person/31` avec `Authorization: Bearer YOUR_API_KEY`, ou utilisez `api_key` dans la chaîne de requête. ## Exemple de requête Cet appel récupère Tom Hanks avec ses crédits combinés. L'exemple Python garde les rôles de films qui ont une date de sortie, les trie du plus récent au plus ancien et en affiche cinq, ainsi que l'URL de la photo. ```bash curl -s "https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits" \ -H "Authorization: Bearer $AMODB_KEY" ``` ```python import os import requests BASE = "https://api.amodb.dev/3" HEADERS = {"Authorization": f"Bearer {os.environ['AMODB_KEY']}"} r = requests.get( f"{BASE}/person/31", params={"language": "en-US", "append_to_response": "combined_credits"}, headers=HEADERS, timeout=10, ) r.raise_for_status() person = r.json() movies = [ c for c in person["combined_credits"]["cast"] if c["media_type"] == "movie" and c.get("release_date") ] movies.sort(key=lambda c: c["release_date"], reverse=True) print(person["name"], person["birthday"], person["known_for_department"]) if person.get("profile_path"): print("Photo:", "https://img.amodb.dev/t/p/w342" + person["profile_path"]) for c in movies[:5]: print(c["release_date"][:4], c["title"], "as", c.get("character") or "n/a") ``` Réponse abrégée pour `language=en-US`. `combined_credits` est réduit à 2 lignes de distribution et 1 ligne d'équipe, et la biographie est raccourcie. ```json { "adult": false, "also_known_as": [ "Thomas Jeffrey Hanks" ], "biography": "Thomas Jeffrey Hanks (born July 9, 1956) is an American actor and filmmaker. Known for...", "birthday": "1956-07-09", "deathday": null, "gender": 2, "homepage": null, "id": 31, "imdb_id": "nm0000158", "known_for_department": "Acting", "name": "Tom Hanks", "place_of_birth": "Concord, California, USA", "popularity": 12.98, "profile_path": "/oFvZoKI6lvU03n4YoNGAll9rkas.jpg", "combined_credits": { "cast": [ { "adult": false, "backdrop_path": "/owUcU7WcM42uPXIVJHglDQceY5R.jpg", "genre_ids": [ 12, 16, 35 ], "id": 1084244, "original_language": "en", "original_title": "Toy Story 5", "overview": "", "popularity": 158.5027, "poster_path": "/sfQtVlIHljToOwYjhe21KPGzZWK.jpg", "release_date": "2026-06-17", "title": "Toy Story 5", "video": false, "vote_average": 8.285, "vote_count": 2649, "media_type": "movie", "credit_id": "65edd5772790bf01634423c9", "character": "Woody (voice)", "order": 0 }, { "adult": false, "backdrop_path": "/1dvOCqKgBcXvfqzVPmAAM5Rv4PP.jpg", "genre_ids": [ 16, 35, 10751 ], "id": 863, "original_language": "en", "original_title": "Toy Story 2", "overview": "", "popularity": 49.6885, "poster_path": "/4rbcp3ng8n1MKHjpeqW0L7Fnpzz.jpg", "release_date": "1999-10-30", "title": "Toy Story 2", "video": false, "vote_average": 7.6, "vote_count": 15484, "media_type": "movie", "credit_id": "5ac0152ec3a368443f034084", "character": "Woody (voice)", "order": 0 } ], "crew": [ { "adult": false, "backdrop_path": "/23GjGDQdMHW5C2UYwSV00fE3FNi.jpg", "first_air_date": "2001-09-09", "genre_ids": [ 18, 10768 ], "id": 4613, "name": "Band of Brothers", "origin_country": [], "original_language": "en", "original_name": "Band of Brothers", "overview": "", "popularity": 63.5427, "poster_path": "/pGzV187ogXzgJrvPRy2YPi29ofH.jpg", "vote_average": 8.608, "vote_count": 4424, "media_type": "tv", "credit_id": "5257765d760ee36aaa522862", "department": "Production", "job": "Executive Producer" } ] } } ``` ## Construire une filmographie Une personne peut apparaître dans `cast` et dans `crew` du même titre, par exemple un acteur qui réalise aussi. Traitez les deux tableaux comme des listes distinctes et fusionnez-les dans votre propre vue. Les lignes de films et de séries utilisent des noms de champs différents : lisez le bon. | Champ | Lignes | Signification | | ---------------------------------- | ----------------------------------- | --------------------------------------- | | `media_type` | crédits combinés | `movie` ou `tv` | | `title` ou `name` | lignes de films ou lignes de séries | Titre affiché | | `release_date` ou `first_air_date` | lignes de films ou lignes de séries | Clé de tri, peut être vide | | `character` | cast | Nom du rôle | | `job`, `department` | crew | Par exemple `Director` dans `Directing` | | `credit_id` | les deux | Identifiant de la ligne de crédit | Triez par date, placez les lignes sans date en dernier et dédoublonnez sur la paire `id` et `media_type`. Les lignes de distribution des séries portent `episode_count`, mais amodb y renvoie `0` : ne l'utilisez donc pas pour compter les épisodes. amodb ne propose ni `GET /3/credit/{credit_id}` ni `aggregate_credits`. Le détail des champs de distribution et d'équipe est sur [crédits](https://amodb.dev/fr/credits/). ## Photos de profil `profile_path` s'ajoute à l'hôte d'images : `https://img.amodb.dev/t/p/{size}{profile_path}`. Utilisez `w185` pour les miniatures de liste, `h632` pour une page de profil et `original` pour les téléchargements. Les images n'exigent aucune clé et sont mises en cache 30 jours. Pour plus d'une photo, appelez `GET /3/person/{person_id}/images`. Le tableau `profiles` contient `file_path`, `width`, `height`, `aspect_ratio` et `vote_average`, ce qui permet de choisir le portrait le mieux noté. Les tables de tailles et `srcset` sont sur [images](https://amodb.dev/fr/images-api/). ## Personnes populaires, recherche et recherche par identifiant - `GET /3/person/popular?page=1` renvoie une liste paginée. Les pages vont de 1 à 500, et la liste est mise en cache 30 minutes. - `GET /3/search/person?query=tom+hanks` cherche par nom. Mis en cache 10 minutes. - `GET /3/find/{external_id}?external_source=imdb_id` associe un identifiant de nom IMDb à une personne. Lisez `person_results` dans la réponse. Voir [recherche par identifiant externe](https://amodb.dev/fr/find-by-external-id/). ## Comparaison | Capacité | Extraire les pages soi-même | API de métadonnées avec offre gratuite | amodb | | --------------------------------- | ------------------------------------------ | -------------------------------------- | ------------------------------------------- | | Filmographie | Parcourir une page par crédit | Voir leur documentation | `combined_credits` en un seul appel | | Séparation distribution et équipe | Analyser les titres de sections | Voir leur documentation | Tableaux `cast` et `crew` | | Photos | Télécharger et redimensionner soi-même | Voir leur documentation | Tailles fixes sur `img.amodb.dev`, sans clé | | Recherche par nom | Piloter un formulaire de recherche de site | Voir leur documentation | `GET /3/search/person` | | Correspondance d'identifiants | Associer par nom | Voir leur documentation | `/3/find` avec `imdb_id` | | Langues | Une langue par site | Voir leur documentation | 14 langues via `language` | ## Tarifs Payez d'avance 1, 3, 6, 12 ou 24 mois. Les périodes plus longues donnent 0, 10, 20, 30 ou 40 pour cent de réduction, et les offres ne se renouvellent jamais toutes seules. Les trois offres autorisent 20, 40 et 120 requêtes par minute, et chacune renvoie tous les points de terminaison people. Une grille de distribution pour un film coûte une seule requête de crédits, car les noms et les chemins de profil y sont inclus, et une page de personne coûte une requête avec les crédits ajoutés. Choisissez le débit qui correspond à vos pages vues. Pas d'offre gratuite. Commencez sur les [tarifs](https://amodb.dev/fr/pricing/). ## Questions et réponses ### Comment obtenir tous les films et séries où un acteur a joué ? Appelez GET /3/person/{person_id}/combined_credits, ou ajoutez append_to_response=combined_credits à l'appel de la personne. Le tableau cast contient les rôles des films et des séries, chacun marqué par media_type : une seule requête couvre toute la filmographie. ### Puis-je trouver un acteur par son nom ? Oui. GET /3/search/person avec le paramètre query renvoie les personnes correspondantes avec leurs identifiants, noms et chemins de profil. Les résultats de recherche sont mis en cache 10 minutes, donc les recherches répétées d'un nom populaire coûtent peu. ### D'où viennent les photos d'acteurs et faut-il une clé ? Chaque personne a un profile_path. Ajoutez-le à https://img.amodb.dev/t/p/{size} avec une taille comme w185 ou h632. Les requêtes d'images n'exigent aucune clé, et la périphérie conserve les images 30 jours. ### Comment associer un acteur à un identifiant de nom IMDb ? Appelez GET /3/find/{external_id}?external_source=imdb_id et lisez person_results. La fiche de la personne renvoie aussi imdb_id, donc vous pouvez stocker les deux identifiants côte à côte et chercher dans les deux sens. ### Les biographies existent-elles dans d'autres langues ? Oui, via le paramètre language, pour les 14 langues servies. Le nom suit votre langue quand une traduction existe. Quand une biographie n'a pas de traduction, la fiche de la personne renvoie le texte anglais. ## Pages liées - [API de détails de personne](https://amodb.dev/fr/people/): API de détails de personne aux chemins et au JSON de TMDB v3 : biographie, filmographie, ids externes et liste populaire d'un acteur ou d'un membre de l'équipe. - [API des crédits](https://amodb.dev/fr/credits/): API crédits aux chemins et au JSON de TMDB v3. Distribution et équipe des films, séries, saisons et épisodes, avec les champs order, department et job. - [API d'images et hôte d'images](https://amodb.dev/fr/images-api/): API d'images de films aux chemins TMDB v3 : listez affiches, fonds, logos et images par titre, puis chargez-les depuis img.amodb.dev en 10 tailles sans clé. - [API de recherche](https://amodb.dev/fr/search/): API de recherche aux chemins et au JSON de TMDB v3 : films, séries, personnes, collections, sociétés et mots-clés par texte, filtres d'année et pagination. - [Recherche par identifiant externe](https://amodb.dev/fr/find-by-external-id/): Retrouvez un film, une série ou une personne par id IMDb, TVDB, Wikidata ou Kinopoisk avec find de TMDB, puis lisez ids externes et faits Wikidata. - [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/actor-api/