# 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. ## 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 1. Vyberte tarif na stránce [ceník](https://amodb.dev/cs/pricing/). Všechny tarify vracejí stejná data a liší se jen počtem požadavků za minutu. 2. Vygenerujte klíč v panelu účtu. 3. 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. ```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") ``` 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](https://amodb.dev/cs/credits/). ## 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](https://amodb.dev/cs/images-api/). ## 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](https://amodb.dev/cs/find-by-external-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](https://amodb.dev/cs/pricing/). ## 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. ## Související stránky - [API detailu osoby](https://amodb.dev/cs/people/): API detailu osoby se stejnými cestami a JSON jako TMDB v3. Herec či člen štábu podle ID s biografií, filmografií, externími ID a seznamem populárních osob. - [API obsazení a štábu](https://amodb.dev/cs/credits/): API obsazení a štábu se stejnými cestami a JSON jako TMDB v3. Získejte herce a štáb filmů, seriálů, sezón a epizod s poli order, department a job. - [API obrázků a hostitel obrázků](https://amodb.dev/cs/images-api/): API obrázků filmů s cestami TMDB v3: vypište plakáty, pozadí, loga a záběry každého titulu a načtěte je z img.amodb.dev v 10 velikostech bez klíče. - [API vyhledávání](https://amodb.dev/cs/search/): API vyhledávání se stejnými cestami a JSON jako TMDB v3. Najděte filmy, seriály, osoby, kolekce, společnosti a klíčová slova podle textu s filtrem roku. - [Hledání podle externího ID](https://amodb.dev/cs/find-by-external-id/): Najděte film, seriál nebo osobu podle ID z IMDb, TVDB, Wikidata nebo Kinopoisk přes endpoint find TMDB a čtěte externí ID a fakta z Wikidata o titulu. - [Rychlý start](https://amodb.dev/cs/quickstart/): První volání amodb: získejte klíč, vyžádejte detail filmu v curl, JavaScriptu, Pythonu, PHP nebo Go a načtěte plakát z img.amodb.dev. Za méně než 2 minuty. Aktualizováno: 2026-10-18. Source: https://amodb.dev/cs/actor-api/