API aktorów

API aktorów to rodzina endpointów osób z TMDB v3 pod adresem api.amodb.dev/3. Osobę pobierzesz przez GET /3/person/{person_id}, dodając combined_credits dostaniesz pełną filmografię, a dodając images zdjęcia profilowe. Lista popularnych osób, wyszukiwanie po nazwisku i wyszukiwanie po ID z IMDb używają tego samego klucza i kształtu JSON.

Zobacz plany Przeczytaj szybki start

Żądanie

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

Odpowiedź 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",

Wyszukiwanie aktora i jego filmografii

GET /3/person/{person_id} zwraca biografię, dane urodzenia i ścieżkę do zdjęcia profilowego jednej osoby. Dodaj append_to_response=combined_credits, a ta sama odpowiedź zawiera też wszystkie role filmowe i serialowe. ID to numeryczne ID osób używane przez TMDB, na przykład 31 dla Toma Hanksa.

Dostajesz rekord osoby, filmografię obsady i ekipy, zdjęcia profilowe oraz listy do odkrywania. Aktorzy, reżyserzy i scenarzyści są w tych samych endpointach i różnią się wartością known_for_department.

Jakie dane dostajesz

Endpoint	Zwraca
`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`	Role filmowe w `cast` i stanowiska w `crew`
`GET /3/person/{person_id}/tv_credits`	To samo dla seriali
`GET /3/person/{person_id}/combined_credits`	Filmy i seriale w jednej liście, oznaczone `media_type`
`GET /3/person/{person_id}/images`	Tablica `profiles` ze zdjęciami
`GET /3/person/popular`	Lista popularnych osób z paginacją
`GET /3/search/person`	Osoby pasujące do `query`

Start w 3 krokach

Wybierz plan na stronie cennik. Wszystkie plany zwracają te same dane i różnią się tylko liczbą żądań na minutę.
Wygeneruj klucz w panelu konta.
Wyślij GET /3/person/31 z Authorization: Bearer YOUR_API_KEY albo użyj api_key w query string.

Przykładowe żądanie

To wywołanie pobiera Toma Hanksa wraz z combined credits. Przykład w Pythonie zostawia role filmowe z datą premiery, sortuje je od najnowszych i wypisuje pięć, a do tego URL zdjęcia.

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

Przycięta odpowiedź dla language=en-US. combined_credits jest przycięte do 2 wierszy obsady i 1 wiersza ekipy, a biografia jest skrócona.

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

Budowanie filmografii

Osoba może występować w cast i w crew tego samego tytułu, na przykład aktor, który także reżyseruje. Traktuj obie tablice jako osobne listy i scal je we własnym widoku. Wiersze filmów i seriali używają różnych nazw pól, więc czytaj właściwe.

Pole	Wiersze	Znaczenie
`media_type`	combined credits	`movie` lub `tv`
`title` lub `name`	wiersze filmów lub seriali	Wyświetlany tytuł
`release_date` lub `first_air_date`	wiersze filmów lub seriali	Klucz sortowania, może być pusty
`character`	cast	Nazwa roli
`job`, `department`	crew	Na przykład `Director` w `Directing`
`credit_id`	oba	ID wiersza roli

Sortuj po dacie, wiersze bez daty dawaj na koniec i usuwaj duplikaty po parze id i media_type. Wiersze obsady seriali niosą episode_count, ale amodb zwraca tam 0, więc nie używaj tego pola do liczenia odcinków. amodb nie udostępnia GET /3/credit/{credit_id} ani aggregate_credits. Szczegóły pól obsady i ekipy są na stronie obsada i ekipa.

Zdjęcia profilowe

profile_path łączy się z hostem obrazów: https://img.amodb.dev/t/p/{size}{profile_path}. Użyj w185 dla miniatur na listach, h632 dla strony profilu i original do pobierania. Obrazy nie wymagają klucza i są w cache przez 30 dni.

Dla więcej niż jednego zdjęcia wywołaj GET /3/person/{person_id}/images. Tablica profiles ma file_path, width, height, aspect_ratio i vote_average, więc możesz wybrać najwyżej ocenianą fotografię. Tabele rozmiarów i srcset są na stronie obrazy.

Popularne osoby, wyszukiwanie i wyszukiwanie po ID

GET /3/person/popular?page=1 zwraca listę z paginacją. Strony biegną od 1 do 500, a lista jest w cache przez 30 minut.
GET /3/search/person?query=tom+hanks dopasowuje po nazwisku. W cache przez 10 minut.
GET /3/find/{external_id}?external_source=imdb_id mapuje ID nazwiska z IMDb na osobę. W odpowiedzi czytaj person_results. Zobacz wyszukiwanie po zewnętrznym ID.

Jak wypada w porównaniu

Możliwość	Własny scraping stron	API z metadanymi i darmowym planem	amodb
Filmografia	Przejść jedną stronę na każdą rolę	Sprawdź ich dokumentację	`combined_credits` w jednym wywołaniu
Podział obsady i ekipy	Parsować nagłówki sekcji	Sprawdź ich dokumentację	Tablice `cast` i `crew`
Zdjęcia	Pobierać i zmniejszać samodzielnie	Sprawdź ich dokumentację	Stałe rozmiary na `img.amodb.dev`, bez klucza
Wyszukiwanie po nazwisku	Obsługiwać formularz wyszukiwania strony	Sprawdź ich dokumentację	`GET /3/search/person`
Mapowanie ID	Dopasowywać po nazwisku	Sprawdź ich dokumentację	`/3/find` z `imdb_id`
Języki	Jedna lokalizacja na stronę	Sprawdź ich dokumentację	14 języków przez `language`

Cennik

Płacisz z góry za 1, 3, 6, 12 lub 24 miesiące. Dłuższe okresy mają zniżkę 0, 10, 20, 30 lub 40 procent, a plany nigdy nie odnawiają się same. Trzy plany dopuszczają 20, 40 i 120 żądań na minutę i każdy zwraca wszystkie endpointy osób. Siatka obsady filmu kosztuje jedno żądanie credits, bo imiona i ścieżki do zdjęć przychodzą razem z nią, a strona osoby kosztuje jedno żądanie z dołączonymi credits. Wybierz tempo odpowiednie do liczby odsłon stron. Brak darmowego planu. Zacznij na stronie cennik.

Pytania i odpowiedzi

Jak pobrać wszystkie filmy i seriale, w których wystąpił aktor?

Wywołaj GET /3/person/{person_id}/combined_credits albo dodaj append_to_response=combined_credits do wywołania osoby. Tablica cast zawiera role z filmów i seriali, każdą oznaczoną media_type, więc jedno żądanie obejmuje całą filmografię.

Czy mogę znaleźć aktora po nazwisku?

Tak. GET /3/search/person z parametrem query zwraca pasujące osoby z ID, nazwiskami i ścieżkami do zdjęć profilowych. Wyniki wyszukiwania są w cache przez 10 minut, więc powtarzane wyszukiwania popularnego nazwiska są tanie.

Skąd pochodzą zdjęcia aktorów i czy wymagają klucza?

Każda osoba ma profile_path. Dołącz go do https://img.amodb.dev/t/p/{size} z rozmiarem takim jak w185 lub h632. Żądania obrazów nie wymagają klucza, a edge trzyma obrazy przez 30 dni.

Jak dopasować aktora do ID nazwiska z IMDb?

Wywołaj GET /3/find/{external_id}?external_source=imdb_id i odczytaj person_results. Rekord osoby zwraca też imdb_id, więc możesz zapisać oba ID obok siebie i wyszukiwać w obu kierunkach.

Czy biografie są dostępne w innych językach?

Tak, przez parametr language, dla 14 obsługiwanych języków. Nazwisko zależy od wybranego języka, jeśli istnieje tłumaczenie. Gdy biografia nie ma tłumaczenia, rekord osoby zwraca tekst angielski.

Zaktualizowano 18 paź 2026

Zobacz jako Markdown