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.

Vezi planurile Citește ghidul rapid

Cerere

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ăspuns 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",

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

Alege un plan la prețuri. Toate planurile întorc aceleași date și diferă doar prin numărul de cereri pe minut.
Generează o cheie în panoul contului tău.
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.

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ă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.

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.

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.

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.

Î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ă.

Actualizat 18 oct. 2026

Vezi ca Markdown