# 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/bg/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/bg/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/bg/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/bg/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/bg/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/bg/people/): API за детайли на личност със същите пътища и JSON като TMDB v3. Актьор или член на екип по id с биография, филмография, външни id и списък с популярни. - [API за участниците](https://amodb.dev/bg/credits/): API за участници със същите пътища и JSON като TMDB v3. Актьори и екип за филми, сериали, сезони и епизоди, с полета order, department и job. - [API за изображения и хост за изображения](https://amodb.dev/bg/images-api/): API за изображения на филми с пътища на TMDB v3: списъци с постери, фонови изображения, лога и кадри, после зареждане от img.amodb.dev в 10 размера без ключ. - [API за търсене](https://amodb.dev/bg/search/): API за търсене със същите пътища и JSON като TMDB v3. Намира филми, сериали, личности, колекции, компании и ключови думи по текст, с филтър по година. - [Търсене по външен идентификатор](https://amodb.dev/bg/find-by-external-id/): Търсете филм, сериал или личност по IMDb, TVDB, Wikidata или Kinopoisk id с ендпойнта find на TMDB и четете външни id и факти от Wikidata за заглавие. - [Бърз старт](https://amodb.dev/bg/quickstart/): Първата ви заявка към amodb: вземете ключ, поискайте детайли за филм с curl, JavaScript, Python, PHP или Go и заредете постера от img.amodb.dev. До 2 минути. Обновено: 2026-10-18. Source: https://amodb.dev/bg/actor-api/