# 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. ## 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 1. Scegli un piano nella pagina dei [prezzi](https://amodb.dev/it/pricing/). Tutti i piani restituiscono gli stessi dati e differiscono solo per le richieste al minuto. 2. Genera una chiave nella dashboard del tuo account. 3. 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. ```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") ``` 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](https://amodb.dev/it/credits/). ## 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](https://amodb.dev/it/images-api/). ## 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](https://amodb.dev/it/find-by-external-id/). ## 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](https://amodb.dev/it/pricing/). ## 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. ## Pagine correlate - [API dei dettagli della persona](https://amodb.dev/it/people/): API dettagli persona con gli stessi percorsi e JSON di TMDB v3. Ottieni attore o troupe per ID, con biografia, filmografia, ID esterni e lista dei popolari. - [API dei crediti](https://amodb.dev/it/credits/): API crediti con gli stessi percorsi e JSON di TMDB v3. Ottieni cast e troupe di film, serie, stagioni ed episodi, con i campi order, department e job. - [API delle immagini e host delle immagini](https://amodb.dev/it/images-api/): API immagini dei film con percorsi TMDB v3: elenca locandine, sfondi, loghi e fermi immagine di ogni titolo e caricali da img.amodb.dev in 10 dimensioni. - [API di ricerca](https://amodb.dev/it/search/): API di ricerca con percorsi e JSON di TMDB v3. Trova film, serie, persone, collezioni, società e parole chiave per testo, con filtri anno e paginazione. - [Ricerca per ID esterno](https://amodb.dev/it/find-by-external-id/): Cerca un film, una serie o una persona per ID IMDb, TVDB, Wikidata o Kinopoisk con l'endpoint find di TMDB, e leggi ID esterni e dati Wikidata di un titolo. - [Avvio rapido](https://amodb.dev/it/quickstart/): Fai la prima chiamata ad amodb: ottieni una chiave, richiedi i dettagli di un film in curl, JavaScript, Python, PHP o Go, carica la locandina. Meno di 2 minuti. Aggiornato: 2026-10-18. Source: https://amodb.dev/it/actor-api/