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.

Voir les offres Lire le démarrage rapide

Requête

curl Python

bashpy

curl -s "https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits" \
  -H "Authorization: Bearer $AMODB_KEY"

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 200

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

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

Choisissez une offre sur les tarifs. Toutes les offres renvoient les mêmes données et ne diffèrent que par le nombre de requêtes par minute.
Générez une clé dans le tableau de bord de votre compte.
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.

curl Python

bashpy

curl -s "https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits" \
  -H "Authorization: Bearer $AMODB_KEY"

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.

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.

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.

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.

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.

Mis à jour le 18 oct. 2026

Voir en Markdown