# 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. ## 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 1. Wybierz plan na stronie [cennik](https://amodb.dev/pl/pricing/). Wszystkie plany zwracają te same dane i różnią się tylko liczbą żądań na minutę. 2. Wygeneruj klucz w panelu konta. 3. 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. ```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") ``` 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](https://amodb.dev/pl/credits/). ## 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](https://amodb.dev/pl/images-api/). ## 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](https://amodb.dev/pl/find-by-external-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](https://amodb.dev/pl/pricing/). ## 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. ## Powiązane strony - [API szczegółów osoby](https://amodb.dev/pl/people/): API szczegółów osoby z tymi samymi ścieżkami i JSON co TMDB v3. Aktor lub ekipa po ID z biografią, filmografią, zewnętrznymi ID i listą popularnych osób. - [API obsady i ekipy](https://amodb.dev/pl/credits/): API obsady i ekipy z tymi samymi ścieżkami i JSON co TMDB v3. Pobierz obsadę i ekipę filmów, seriali, sezonów i odcinków z polami order, department i job. - [API obrazów i host obrazów](https://amodb.dev/pl/images-api/): API obrazów filmów ze ścieżkami TMDB v3: wypisz plakaty, tła, loga i kadry każdego tytułu, a potem ładuj je z img.amodb.dev w 10 rozmiarach bez klucza. - [API wyszukiwania](https://amodb.dev/pl/search/): API wyszukiwania z tymi samymi ścieżkami i JSON co TMDB v3. Znajdź filmy, seriale, osoby, kolekcje, firmy i słowa kluczowe po tekście, z filtrem roku. - [Wyszukiwanie po zewnętrznym ID](https://amodb.dev/pl/find-by-external-id/): Znajdź film, serial lub osobę po ID z IMDb, TVDB, Wikidata lub Kinopoisk przez endpoint find z TMDB oraz odczytaj zewnętrzne ID i fakty z Wikidata o tytule. - [Szybki start](https://amodb.dev/pl/quickstart/): Pierwsze wywołanie amodb: zdobądź klucz, pobierz szczegóły filmu w curl, JavaScript, Python, PHP lub Go, potem załaduj plakat z img.amodb.dev. Poniżej 2 minut. Zaktualizowano: 2026-10-18. Source: https://amodb.dev/pl/actor-api/