# API акцёраў > API акцёраў гэта сямейства эндпоінтаў людзей TMDB v3 па адрасе api.amodb.dev/3. Атрымайце персону праз GET /3/person/{person_id}, дадайце combined_credits для поўнай фільмаграфіі і images для фота профілю. Спіс папулярных, пошук па імені і пошук па IMDb id працуюць з тым жа ключом і той жа формай JSON. ## Пошук акцёра і яго фільмаграфіі `GET /3/person/{person_id}` вяртае біяграфію, даныя пра нараджэнне і шлях да выявы профілю для адной персоны. Дадайце `append_to_response=combined_credits`, і той жа адказ будзе ўтрымліваць таксама кожны ўдзел у фільмах і серыялах. Id гэта лікавыя id персон, якія выкарыстоўвае TMDB, напрыклад `31` для Tom Hanks. Вы атрымліваеце запіс персоны, фільмаграфію акцёрскага складу і здымачнай групы, фота профілю і спісы для знаходжання новых імёнаў. Акцёры, рэжысёры і сцэнарысты жывуць у тых жа эндпоінтах і адрозніваюцца па `known_for_department`. ## Якія даныя вы атрымліваеце | Эндпоінт | Што вяртае | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `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` | Ролі ў фільмах у `cast` і пасады ў `crew` | | `GET /3/person/{person_id}/tv_credits` | Тое ж для серыялаў | | `GET /3/person/{person_id}/combined_credits` | Фільмы і серыялы ў адным спісе з пазнакай `media_type` | | `GET /3/person/{person_id}/images` | Масіў `profiles` з фота | | `GET /3/person/popular` | Спіс папулярных людзей па старонках | | `GET /3/search/person` | Людзі, што супадаюць з `query` | ## Пачніце за 3 крокі 1. Абярыце план на старонцы [цэны](https://amodb.dev/be/pricing/). Усе планы вяртаюць аднолькавыя даныя і адрозніваюцца толькі запытамі ў хвіліну. 2. Згенеруйце ключ у асабістым кабінеце. 3. Адпраўце `GET /3/person/31` з `Authorization: Bearer YOUR_API_KEY` або выкарыстайце `api_key` у радку запыту. ## Прыклад запыту Гэты выклік атрымлівае Tom Hanks з яго зводнымі ўдзеламі. Прыклад на Python пакідае ролі ў фільмах з датай выхаду, сартуе іх ад новых да старых і друкуе пяць, плюс URL фота. ```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") ``` Скарочаны адказ для `language=en-US`. `combined_credits` скарочаны да 2 радкоў cast і 1 радка crew, а біяграфія карацейшая. ```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" } ] } } ``` ## Складанне фільмаграфіі Персона можа з’яўляцца і ў `cast`, і ў `crew` аднаго і таго ж фільма, напрыклад акцёр, які таксама здымае. Лічыце два масівы асобнымі спісамі і аб’ядноўвайце іх у сваім прадстаўленні. Радкі фільмаў і серыялаў маюць розныя назвы палёў, таму чытайце патрэбнае. | Поле | Радкі | Значэнне | | ----------------------------------- | -------------------------------- | ---------------------------------- | | `media_type` | зводныя ўдзелы | `movie` або `tv` | | `title` або `name` | радкі фільмаў або радкі серыялаў | Назва для паказу | | `release_date` або `first_air_date` | радкі фільмаў або радкі серыялаў | Ключ сартавання, можа быць пустым | | `character` | cast | Назва ролі | | `job`, `department` | crew | Напрыклад `Director` у `Directing` | | `credit_id` | абодва | Id радка ўдзелу | Сартуйце па даце, ставіце радкі без даты ў канец і выдаляйце дублікаты па пары `id` і `media_type`. Радкі акцёраў серыялаў нясуць `episode_count`, але amodb вяртае там `0`, таму не выкарыстоўвайце яго для падліку эпізодаў. amodb не прапануе `GET /3/credit/{credit_id}` і `aggregate_credits`. Падрабязнасці пра палі акцёраў і групы ёсць на старонцы [удзельнікі](https://amodb.dev/be/credits/). ## Фота профілю `profile_path` далучаецца да хоста выяў: `https://img.amodb.dev/t/p/{size}{profile_path}`. Выкарыстоўвайце `w185` для мініяцюр у спісах, `h632` для старонкі профілю і `original` для спампоўкі. Выявы не патрабуюць ключа і кэшуюцца на 30 дзён. Каб атрымаць больш за адно фота, выклічце `GET /3/person/{person_id}/images`. Масіў `profiles` мае `file_path`, `width`, `height`, `aspect_ratio` і `vote_average`, таму можна выбраць партрэт з найлепшай ацэнкай. Табліцы памераў і `srcset` ёсць на старонцы [выявы](https://amodb.dev/be/images-api/). ## Папулярныя людзі, пошук і пошук па id - `GET /3/person/popular?page=1` вяртае спіс па старонках. Старонкі ідуць ад 1 да 500, а спіс кэшуецца на 30 хвілін. - `GET /3/search/person?query=tom+hanks` шукае па імені. Кэшуецца на 10 хвілін. - `GET /3/find/{external_id}?external_source=imdb_id` супастаўляе IMDb id імя з персонай. Чытайце `person_results` у адказе. Гл. [пошук па вонкавым ідэнтыфікатары](https://amodb.dev/be/find-by-external-id/). ## Параўнанне | Магчымасць | Уласны скрэйпінг старонак | API метаданых з бясплатным тарыфам | amodb | | ---------------------- | ------------------------------------- | ---------------------------------- | ----------------------------------------------- | | Фільмаграфія | Абыходзіць па адной старонцы на ўдзел | Глядзіце іх дакументацыю | `combined_credits` за адзін выклік | | Падзел акцёраў і групы | Разбор загалоўкаў раздзелаў | Глядзіце іх дакументацыю | Масівы `cast` і `crew` | | Фота | Спампоўваць і змяняць памер самім | Глядзіце іх дакументацыю | Фіксаваныя памеры на `img.amodb.dev`, без ключа | | Пошук па імені | Кіраваць формай пошуку сайта | Глядзіце іх дакументацыю | `GET /3/search/person` | | Супастаўленне id | Супастаўленне па імені | Глядзіце іх дакументацыю | `/3/find` з `imdb_id` | | Мовы | Адна лакаль на сайт | Глядзіце іх дакументацыю | 14 моў праз `language` | ## Цэны Плаціце наперад за 1, 3, 6, 12 або 24 месяцы. Доўгія перыяды даюць зніжку 0, 10, 20, 30 або 40 працэнтаў, а планы ніколі не прадаўжаюцца самі. Тры планы дазваляюць 20, 40 і 120 запытаў у хвіліну, і кожны вяртае ўсе эндпоінты людзей. Сетка акцёраў фільма каштуе адзін запыт удзельнікаў, бо імёны і шляхі профілю ідуць разам з ім, а старонка персоны каштуе адзін запыт з далучанымі ўдзеламі. Абярыце частату, якая адпавядае вашым праглядам старонак. Бясплатнага тарыфа няма. Пачніце са старонкі [цэны](https://amodb.dev/be/pricing/). ## Пытанні і адказы ### Як атрымаць усе фільмы і серыялы, дзе здымаўся акцёр? Выклічце GET /3/person/{person_id}/combined_credits або дадайце append_to_response=combined_credits да выкліку персоны. Масіў cast змяшчае ролі з фільмаў і серыялаў, кожную з пазнакай media_type, таму адзін запыт ахоплівае ўсю фільмаграфію. ### Ці можна знайсці акцёра па імені? Так. GET /3/search/person з параметрам query вяртае людзей, якія супадаюць, з id, імёнамі і шляхамі профілю. Вынікі пошуку кэшуюцца на 10 хвілін, таму паўторныя пошукі папулярнага імя абыходзяцца танна. ### Адкуль бяруцца фота акцёраў і ці патрэбны ключ? Кожная персона мае profile_path. Далучыце яго да https://img.amodb.dev/t/p/{size} з памерам, напрыклад w185 або h632. Запыты на выявы не патрабуюць ключа, а edge захоўвае выявы 30 дзён. ### Як супаставіць акцёра з IMDb id імя? Выклічце GET /3/find/{external_id}?external_source=imdb_id і прачытайце person_results. Запіс персоны таксама вяртае imdb_id, таму абодва id можна захоўваць побач і шукаць у любым напрамку. ### Ці даступныя біяграфіі на іншых мовах? Так, праз параметр language, для 14 падтрымліваных моў. Імя адпавядае вашай мове, калі пераклад існуе. Калі ў біяграфіі няма перакладу, запіс персоны вяртае англійскі тэкст. ## Звязаныя старонкі - [API дэталяў персоны](https://amodb.dev/be/people/): API дэталяў персоны з тымі ж шляхамі і JSON, што ў TMDB v3. Акцёр ці член групы па id з біяграфіяй, фільмаграфіяй, вонкавымі id і спісам папулярных. - [API ўдзельнікаў](https://amodb.dev/be/credits/): API ўдзельнікаў з тымі ж шляхамі і JSON, што ў TMDB v3. Акцёры і здымачная група фільмаў, серыялаў, сезонаў і эпізодаў з палямі order, department і job. - [API выяў і хост выяў](https://amodb.dev/be/images-api/): API выяў фільмаў з шляхамі TMDB v3: спісы постэраў, фонавых выяў, лагатыпаў і кадраў назвы, а потым загрузка з img.amodb.dev у 10 памерах без ключа. - [API пошуку](https://amodb.dev/be/search/): API пошуку з шляхамі і JSON як у TMDB v3. Фільмы, серыялы, персоны, калекцыі, кампаніі і ключавыя словы па тэксце, з фільтрамі па годзе і старонкамі. - [Пошук па вонкавым ідэнтыфікатары](https://amodb.dev/be/find-by-external-id/): Шукайце фільм, серыял або персону па IMDb, TVDB, Wikidata ці Kinopoisk id праз эндпоінт find TMDB і чытайце вонкавыя id і факты Wikidata для назвы. - [Хуткі старт](https://amodb.dev/be/quickstart/): Першы выклік да amodb: атрымайце ключ, запытайце дэталі фільма ў curl, JavaScript, Python, PHP або Go і загрузіце постэр з img.amodb.dev. Менш за 2 хвіліны. Абноўлена: 2026-10-18. Source: https://amodb.dev/be/actor-api/