API pro herce

API pro herce je rodina endpointů osob v TMDB v3 na api.amodb.dev/3. Osobu načtete přes GET /3/person/{person_id}, přidáním combined_credits získáte celou filmografii a přidáním images profilové fotografie. Seznam populárních osob, hledání podle jména i vyhledání podle IMDb ID používají stejný klíč a stejný tvar JSON.

Zobrazit tarify Přečíst rychlý start

Požadavek

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

Odpověď 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",

Vyhledání herce a jeho filmografie

GET /3/person/{person_id} vrací biografii, data narození a cestu k profilovému obrázku jedné osoby. Přidejte append_to_response=combined_credits a stejná odpověď obsahuje i všechny filmové a seriálové záznamy účasti. ID jsou číselná ID osob, která používá TMDB, například 31 pro Toma Hankse.

Dostanete záznam osoby, filmografii obsazení a štábu, profilové fotografie a seznamy pro objevování. Herci, režiséři a scenáristé žijí ve stejných endpointech a liší se hodnotou known_for_department.

Jaká data dostanete

Endpoint	Vrací
`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`	Filmové role v `cast` a profese v `crew`
`GET /3/person/{person_id}/tv_credits`	Totéž pro seriály
`GET /3/person/{person_id}/combined_credits`	Filmy a seriály v jednom seznamu, označené `media_type`
`GET /3/person/{person_id}/images`	Pole `profiles` s fotografiemi
`GET /3/person/popular`	Stránkovaný seznam populárních osob
`GET /3/search/person`	Osoby odpovídající `query`

Začněte ve 3 krocích

Vyberte tarif na stránce ceník. Všechny tarify vracejí stejná data a liší se jen počtem požadavků za minutu.
Vygenerujte klíč v panelu účtu.
Pošlete GET /3/person/31 s Authorization: Bearer YOUR_API_KEY nebo použijte api_key v řetězci dotazu.

Příklad požadavku

Toto volání načte Toma Hankse včetně combined credits. Ukázka v Pythonu ponechá filmové role s datem vydání, seřadí je od nejnovějších a vypíše pět, plus URL fotografie.

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

Zkrácená odpověď pro language=en-US. combined_credits je zkráceno na 2 řádky obsazení a 1 řádek štábu a biografie je zkrácena.

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

Sestavení filmografie

Osoba se může objevit v cast i v crew stejného titulu, například herec, který také režíruje. Berte obě pole jako samostatné seznamy a sloučte je ve vlastním zobrazení. Řádky filmů a seriálů používají různé názvy polí, proto čtěte to správné.

Pole	Řádky	Význam
`media_type`	combined credits	`movie` nebo `tv`
`title` nebo `name`	řádky filmů nebo seriálů	Zobrazovaný název
`release_date` nebo `first_air_date`	řádky filmů nebo seriálů	Klíč řazení, může být prázdný
`character`	cast	Název role
`job`, `department`	crew	Například `Director` v `Directing`
`credit_id`	obojí	ID řádku záznamu

Seřaďte podle data, řádky bez data dejte na konec a deduplikujte podle dvojice id a media_type. Řádky seriálového obsazení nesou episode_count, ale amodb tam vrací 0, takže ho nepoužívejte k počítání epizod. amodb nenabízí GET /3/credit/{credit_id} ani aggregate_credits. Podrobnosti o polích obsazení a štábu jsou na stránce obsazení a štáb.

Profilové fotografie

profile_path se připojuje k hostiteli obrázků: https://img.amodb.dev/t/p/{size}{profile_path}. Použijte w185 pro miniatury v seznamech, h632 pro stránku profilu a original pro stahování. Obrázky nepotřebují klíč a cachují se 30 dní.

Pro více než jednu fotografii zavolejte GET /3/person/{person_id}/images. Pole profiles obsahuje file_path, width, height, aspect_ratio a vote_average, takže můžete vybrat nejlépe hodnocený portrét. Tabulky velikostí a srcset jsou na stránce obrázky.

Populární osoby, hledání a vyhledání podle ID

GET /3/person/popular?page=1 vrací stránkovaný seznam. Stránky jsou od 1 do 500 a seznam se cachuje 30 minut.
GET /3/search/person?query=tom+hanks hledá podle jména. Cachuje se 10 minut.
GET /3/find/{external_id}?external_source=imdb_id přiřadí IMDb ID jména k osobě. V odpovědi čtěte person_results. Viz hledání podle externího ID.

Jak si stojí v porovnání

Schopnost	Vlastní scrapování stránek	API s metadaty a bezplatným tarifem	amodb
Filmografie	Projít jednu stránku na každý záznam	Podívejte se do jejich dokumentace	`combined_credits` v jediném volání
Rozdělení obsazení a štábu	Parsovat nadpisy sekcí	Podívejte se do jejich dokumentace	Pole `cast` a `crew`
Fotografie	Stáhnout a zmenšit vlastními silami	Podívejte se do jejich dokumentace	Pevné velikosti na `img.amodb.dev`, bez klíče
Hledání podle jména	Ovládat vyhledávací formulář webu	Podívejte se do jejich dokumentace	`GET /3/search/person`
Přiřazení ID	Párovat podle jména	Podívejte se do jejich dokumentace	`/3/find` s `imdb_id`
Jazyky	Jedna lokalizace na web	Podívejte se do jejich dokumentace	14 jazyků přes `language`

Ceník

Platíte předem za 1, 3, 6, 12 nebo 24 měsíců. Delší období mají slevu 0, 10, 20, 30 nebo 40 procent a tarify se samy neobnovují. Tři tarify povolují 20, 40 a 120 požadavků za minutu a každý vrací všechny endpointy osob. Mřížka obsazení filmu stojí jeden požadavek na obsazení a štáb, protože jména a cesty k profilům jsou součástí odpovědi, a stránka osoby stojí jeden požadavek s přidaným obsazením. Zvolte rychlost podle zobrazení stránek. Žádný bezplatný tarif. Začněte na stránce ceník.

Otázky a odpovědi

Jak získám všechny filmy a seriály, ve kterých herec hrál?

Zavolejte GET /3/person/{person_id}/combined_credits nebo přidejte append_to_response=combined_credits k volání osoby. Pole cast obsahuje role z filmů i seriálů, každou označenou media_type, takže jeden požadavek pokryje celou filmografii.

Mohu najít herce podle jména?

Ano. GET /3/search/person s parametrem query vrací odpovídající osoby s ID, jmény a cestami k profilu. Výsledky hledání se cachují 10 minut, takže opakovaná vyhledání populárního jména jsou levná.

Odkud se berou fotografie herců a potřebují klíč?

Každá osoba má profile_path. Připojte jej k https://img.amodb.dev/t/p/{size} s velikostí jako w185 nebo h632. Požadavky na obrázky klíč nepotřebují a edge uchovává obrázky 30 dní.

Jak přiřadím herce k IMDb ID jména?

Zavolejte GET /3/find/{external_id}?external_source=imdb_id a přečtěte person_results. Záznam osoby vrací také imdb_id, takže si můžete uložit obě ID vedle sebe a vyhledávat oběma směry.

Jsou biografie dostupné v jiných jazycích?

Ano, přes parametr language, pro 14 podporovaných jazyků. Jméno se řídí vaším jazykem, pokud překlad existuje. Pokud biografie překlad nemá, záznam osoby vrací anglický text.

Aktualizováno 18. 10. 2026

Zobrazit jako Markdown