API attori

L'API attori è la famiglia people di TMDB v3 su api.amodb.dev/3. Recupera una persona con GET /3/person/{person_id}, aggiungi combined_credits per la filmografia completa e images per le foto del profilo. Una lista dei popolari, la ricerca per nome e la ricerca per ID IMDb usano la stessa chiave e la stessa struttura JSON.

Vedi i piani Leggi la guida rapida

Richiesta

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

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

Cercare un attore e la sua filmografia

GET /3/person/{person_id} restituisce una biografia, i dati di nascita e il percorso dell'immagine del profilo di una persona. Aggiungi append_to_response=combined_credits e la stessa risposta contiene anche tutti i crediti di film e serie TV. Gli ID sono gli ID numerici delle persone usati da TMDB, per esempio 31 per Tom Hanks.

Ottieni una scheda della persona, una filmografia di cast e troupe, foto del profilo e liste per la scoperta. Attori, registi e sceneggiatori vivono negli stessi endpoint e si distinguono per known_for_department.

Quali dati ottieni

Endpoint	Restituisce
`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`	I ruoli nei film in `cast` e i mestieri in `crew`
`GET /3/person/{person_id}/tv_credits`	Lo stesso per le serie
`GET /3/person/{person_id}/combined_credits`	Film e serie TV in un'unica lista, con il `media_type`
`GET /3/person/{person_id}/images`	Un array `profiles` di foto
`GET /3/person/popular`	Lista paginata delle persone popolari
`GET /3/search/person`	Le persone che corrispondono a una `query`

Parti in 3 passaggi

Scegli un piano nella pagina dei prezzi. Tutti i piani restituiscono gli stessi dati e differiscono solo per le richieste al minuto.
Genera una chiave nella dashboard del tuo account.
Invia GET /3/person/31 con Authorization: Bearer YOUR_API_KEY, oppure usa api_key nella query string.

Esempio di richiesta

Questa chiamata recupera Tom Hanks con i suoi crediti combinati. L'esempio in Python tiene i ruoli nei film che hanno una data di uscita, li ordina dal più recente e ne stampa cinque, più l'URL della foto.

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

Risposta ridotta per language=en-US. combined_credits è tagliato a 2 righe di cast e 1 di troupe, e la biografia è accorciata.

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

Costruire una filmografia

Una persona può comparire in cast e in crew dello stesso titolo, per esempio un attore che dirige anche. Tratta i due array come liste separate e uniscili nella tua vista. Le righe di film e serie TV usano nomi di campo diversi, quindi leggi quello giusto.

Campo	Righe	Significato
`media_type`	crediti combinati	`movie` o `tv`
`title` o `name`	righe di film o righe di serie TV	Titolo da mostrare
`release_date` o `first_air_date`	righe di film o righe di serie TV	Chiave di ordinamento, può essere vuota
`character`	cast	Nome del ruolo
`job`, `department`	crew	Per esempio `Director` in `Directing`
`credit_id`	entrambe	ID della riga di credito

Ordina per data, metti in fondo le righe senza data e rimuovi i duplicati sulla coppia id e media_type. Le righe di cast delle serie TV portano episode_count, ma amodb vi restituisce 0, quindi non usarlo per contare gli episodi. amodb non offre GET /3/credit/{credit_id} né aggregate_credits. I dettagli dei campi di cast e troupe sono nella pagina crediti.

Foto del profilo

profile_path si unisce all'host delle immagini: https://img.amodb.dev/t/p/{size}{profile_path}. Usa w185 per le miniature degli elenchi, h632 per una pagina profilo e original per i download. Le immagini non richiedono alcuna chiave e restano in cache 30 giorni.

Per più di una foto chiama GET /3/person/{person_id}/images. L'array profiles contiene file_path, width, height, aspect_ratio e vote_average, così puoi scegliere il ritratto più votato. Le tabelle delle dimensioni e srcset sono nella pagina immagini.

Persone popolari, ricerca e ricerca per ID

GET /3/person/popular?page=1 restituisce una lista paginata. Le pagine vanno da 1 a 500, e la lista resta in cache 30 minuti.
GET /3/search/person?query=tom+hanks cerca per nome. In cache per 10 minuti.
GET /3/find/{external_id}?external_source=imdb_id associa un ID nome IMDb a una persona. Leggi person_results nella risposta. Vedi ricerca per ID esterno.

Confronto

Funzionalità	Fare scraping delle pagine da solo	API di metadati con piano gratuito	amodb
Filmografia	Scansionare una pagina per ogni credito	Vedi la loro documentazione	`combined_credits` in una sola chiamata
Separazione di cast e troupe	Analizzare i titoli delle sezioni	Vedi la loro documentazione	Array `cast` e `crew`
Foto	Scaricare e ridimensionare da solo	Vedi la loro documentazione	Dimensioni fisse su `img.amodb.dev`, senza chiave
Ricerca per nome	Pilotare il modulo di ricerca di un sito	Vedi la loro documentazione	`GET /3/search/person`
Associazione degli ID	Abbinare per nome	Vedi la loro documentazione	`/3/find` con `imdb_id`
Lingue	Una lingua per sito	Vedi la loro documentazione	14 lingue tramite `language`

Prezzi

Paga in anticipo 1, 3, 6, 12 o 24 mesi. I periodi più lunghi hanno uno sconto di 0, 10, 20, 30 o 40 per cento, e i piani non si rinnovano mai da soli. I tre piani consentono 20, 40 e 120 richieste al minuto, e ognuno restituisce tutti gli endpoint people. Una griglia del cast per un film costa una richiesta di crediti, perché nomi e percorsi del profilo arrivano insieme, e una pagina persona costa una richiesta con i crediti aggiunti. Scegli la frequenza che corrisponde alle tue visualizzazioni di pagina. Nessun piano gratuito. Inizia dalla pagina dei prezzi.

Domande e risposte

Come ottengo tutti i film e le serie in cui ha recitato un attore?

Chiama GET /3/person/{person_id}/combined_credits, oppure aggiungi append_to_response=combined_credits alla chiamata della persona. L'array cast contiene i ruoli di film e serie TV, ciascuno con il suo media_type, quindi una sola richiesta copre l'intera filmografia.

Posso trovare un attore per nome?

Sì. GET /3/search/person con il parametro query restituisce le persone corrispondenti con ID, nomi e percorsi del profilo. I risultati di ricerca restano in cache 10 minuti, quindi le ricerche ripetute di un nome popolare costano poco.

Da dove vengono le foto degli attori e serve una chiave?

Ogni persona ha un profile_path. Uniscilo a https://img.amodb.dev/t/p/{size} con una dimensione come w185 o h632. Le richieste di immagini non richiedono alcuna chiave, e l'edge conserva le immagini per 30 giorni.

Come associo un attore a un ID nome IMDb?

Chiama GET /3/find/{external_id}?external_source=imdb_id e leggi person_results. La scheda della persona restituisce anche imdb_id, quindi puoi salvare i due ID affiancati e cercare in entrambe le direzioni.

Le biografie sono disponibili in altre lingue?

Sì, tramite il parametro language, per le 14 lingue servite. Il nome segue la tua lingua quando esiste una traduzione. Se una biografia non ha traduzione, la scheda della persona restituisce il testo inglese.

Aggiornato il 18 ott 2026

Vedi in Markdown