# API pentru actori > API-ul pentru actori este familia de endpoint-uri pentru persoane din TMDB v3, la api.amodb.dev/3. Obții o persoană cu GET /3/person/{person_id}, adaugi combined_credits pentru filmografia completă și images pentru fotografiile de profil. Lista populară, căutarea după nume și căutarea după ID IMDb folosesc aceeași cheie și aceeași structură JSON. ## Caută un actor și filmografia lui `GET /3/person/{person_id}` întoarce biografia, datele nașterii și calea imaginii de profil pentru o persoană. Adaugă `append_to_response=combined_credits` și același răspuns conține și toate creditele din filme și seriale. ID-urile sunt ID-urile numerice de persoană folosite de TMDB, de exemplu `31` pentru Tom Hanks. Primești o fișă de persoană, o filmografie cu roluri și funcții în echipă, fotografii de profil și liste pentru descoperire. Actorii, regizorii și scenariștii se găsesc în aceleași endpoint-uri și se deosebesc prin `known_for_department`. ## Ce date primești | Endpoint | Întoarce | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `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` | Roluri din filme în `cast` și funcții în `crew` | | `GET /3/person/{person_id}/tv_credits` | Același lucru pentru seriale | | `GET /3/person/{person_id}/combined_credits` | Filme și seriale într-o singură listă, marcate prin `media_type` | | `GET /3/person/{person_id}/images` | Un array `profiles` cu fotografii | | `GET /3/person/popular` | Listă paginată cu persoane populare | | `GET /3/search/person` | Persoanele potrivite cu `query` | ## Începe în 3 pași 1. Alege un plan la [prețuri](https://amodb.dev/ro/pricing/). Toate planurile întorc aceleași date și diferă doar prin numărul de cereri pe minut. 2. Generează o cheie în panoul contului tău. 3. Trimite `GET /3/person/31` cu `Authorization: Bearer YOUR_API_KEY` sau folosește `api_key` în șirul de interogare. ## Exemplu de cerere Acest apel aduce datele lui Tom Hanks împreună cu creditele combinate. Exemplul Python păstrează rolurile din filme care au dată de lansare, le sortează de la cele mai noi și afișează cinci, plus URL-ul fotografiei. ```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ăspuns scurtat pentru `language=en-US`. `combined_credits` este tăiat la 2 rânduri de distribuție și 1 rând de echipă, iar biografia este prescurtată. ```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" } ] } } ``` ## Construiește o filmografie O persoană poate apărea în `cast` și în `crew` pentru același titlu, de exemplu un actor care și regizează. Tratează cele două array-uri ca liste separate și îmbină-le în propria ta vizualizare. Rândurile pentru filme și cele pentru seriale folosesc nume de câmp diferite, așa că citește-l pe cel potrivit. | Câmp | Rânduri | Semnificație | | ----------------------------------- | ----------------------------- | ------------------------------------ | | `media_type` | credite combinate | `movie` sau `tv` | | `title` sau `name` | rânduri de film sau de serial | Titlul afișat | | `release_date` sau `first_air_date` | rânduri de film sau de serial | Cheie de sortare, poate fi goală | | `character` | distribuție | Numele rolului | | `job`, `department` | echipă | De exemplu `Director` în `Directing` | | `credit_id` | ambele | ID-ul rândului de credit | Sortează după dată, pune la final rândurile fără dată și elimină duplicatele după perechea `id` și `media_type`. Rândurile de distribuție pentru seriale au `episode_count`, dar amodb întoarce acolo `0`, deci nu-l folosi pentru a număra episoadele. amodb nu oferă `GET /3/credit/{credit_id}` și nici `aggregate_credits`. Detaliile câmpurilor de distribuție și echipă sunt pe pagina [credite](https://amodb.dev/ro/credits/). ## Fotografii de profil `profile_path` se adaugă la gazda de imagini: `https://img.amodb.dev/t/p/{size}{profile_path}`. Folosește `w185` pentru miniaturi în liste, `h632` pentru o pagină de profil și `original` pentru descărcări. Imaginile nu cer cheie și rămân în cache 30 de zile. Pentru mai multe fotografii apelează `GET /3/person/{person_id}/images`. Array-ul `profiles` are `file_path`, `width`, `height`, `aspect_ratio` și `vote_average`, așa că poți alege portretul cu cea mai bună evaluare. Tabelele de dimensiuni și `srcset` sunt pe pagina [imagini](https://amodb.dev/ro/images-api/). ## Persoane populare, căutare și căutare după ID - `GET /3/person/popular?page=1` întoarce o listă paginată. Paginile merg de la 1 la 500, iar lista este ținută în cache 30 de minute. - `GET /3/search/person?query=tom+hanks` caută după nume. Rezultatele sunt ținute în cache 10 minute. - `GET /3/find/{external_id}?external_source=imdb_id` leagă un ID de nume IMDb de o persoană. Citește `person_results` din răspuns. Vezi [căutare după ID extern](https://amodb.dev/ro/find-by-external-id/). ## Cum se compară | Capacitate | Extragi singur paginile | API de metadate cu nivel gratuit | amodb | | -------------------------------- | ----------------------------------------------- | -------------------------------- | ---------------------------------------------- | | Filmografie | Parcurgi câte o pagină pentru fiecare credit | Vezi documentația lor | `combined_credits` într-un singur apel | | Separarea distribuției de echipă | Analizezi titlurile secțiunilor | Vezi documentația lor | array-urile `cast` și `crew` | | Fotografii | Le descarci și le redimensionezi singur | Vezi documentația lor | Dimensiuni fixe pe `img.amodb.dev`, fără cheie | | Căutare după nume | Automatizezi formularul de căutare al unui site | Vezi documentația lor | `GET /3/search/person` | | Corespondență de ID | Potrivești după nume | Vezi documentația lor | `/3/find` cu `imdb_id` | | Limbi | O singură limbă pe site | Vezi documentația lor | 14 limbi prin `language` | ## Prețuri Plătești în avans pentru 1, 3, 6, 12 sau 24 de luni. Perioadele mai lungi au reduceri de 0, 10, 20, 30 sau 40 la sută, iar planurile nu se reînnoiesc singure. Cele trei planuri permit 20, 40 și 120 de cereri pe minut, iar fiecare întoarce toate endpoint-urile pentru persoane. O grilă de distribuție pentru un film costă o cerere de credite, pentru că numele și căile de profil vin odată cu ea, iar o pagină de persoană costă o cerere cu creditele atașate. Alege ritmul potrivit numărului tău de afișări de pagină. Fără nivel gratuit. Începe de la [prețuri](https://amodb.dev/ro/pricing/). ## Întrebări și răspunsuri ### Cum obțin toate filmele și serialele în care a apărut un actor? Apelează GET /3/person/{person_id}/combined_credits sau adaugă append_to_response=combined_credits la apelul pentru persoană. Array-ul cast conține rolurile din filme și seriale, fiecare marcat cu media_type, deci o singură cerere acoperă toată filmografia. ### Pot găsi un actor după nume? Da. GET /3/search/person cu parametrul query întoarce persoanele potrivite, cu ID-uri, nume și căi de profil. Rezultatele căutării sunt ținute în cache 10 minute, așa că interogările repetate pentru un nume popular costă puțin. ### De unde vin fotografiile actorilor și cer o cheie? Fiecare persoană are un profile_path. Adaugă-l la https://img.amodb.dev/t/p/{size} cu o dimensiune precum w185 sau h632. Cererile de imagini nu cer cheie, iar marginea păstrează imaginile 30 de zile. ### Cum potrivesc un actor cu un ID de nume IMDb? Apelează GET /3/find/{external_id}?external_source=imdb_id și citește person_results. Fișa persoanei întoarce și imdb_id, deci poți stoca ambele ID-uri alături și poți căuta în ambele direcții. ### Sunt disponibile biografiile în alte limbi? Da, prin parametrul language, pentru cele 14 limbi servite. Numele urmează limba ta atunci când există o traducere. Dacă o biografie nu are traducere, fișa persoanei întoarce textul în engleză. ## Pagini conexe - [API detalii persoană](https://amodb.dev/ro/people/): API detalii persoană cu căile și JSON-ul TMDB v3. Preia un actor sau membru al echipei după ID, cu biografie, filmografie, ID-uri externe și lista populară. - [API credite](https://amodb.dev/ro/credits/): API credite cu aceleași căi și același JSON ca TMDB v3. Distribuția și echipa pentru filme, seriale, sezoane și episoade, cu order, department și job. - [API imagini și gazdă de imagini](https://amodb.dev/ro/images-api/): API imagini filme cu căi TMDB v3: listează postere, imagini de fundal, logouri și cadre, apoi încarcă-le de la img.amodb.dev în 10 dimensiuni, fără cheie. - [API căutare](https://amodb.dev/ro/search/): API căutare cu căile și JSON-ul TMDB v3. Găsește filme, seriale, persoane, colecții, companii și cuvinte-cheie după text, cu filtre de an și paginare. - [Căutare după ID extern](https://amodb.dev/ro/find-by-external-id/): Caută un film, serial sau o persoană după ID IMDb, TVDB, Wikidata sau Kinopoisk cu endpoint-ul find și citește ID-urile externe și faptele Wikidata. - [Ghid rapid](https://amodb.dev/ro/quickstart/): Fă primul apel amodb: ia o cheie, cere detaliile unui film în curl, JavaScript, Python, PHP sau Go, apoi încarcă posterul de pe img.amodb.dev. Sub 2 minute. Actualizat: 2026-10-18. Source: https://amodb.dev/ro/actor-api/