# API акторів > API акторів це родина ендпоінтів people з 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/uk/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 рядків акторського складу та 1 рядка знімальної групи, а біографію скорочено. ```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` | combined credits | `movie` або `tv` | | `title` або `name` | рядки фільмів або серіалів | Назва для показу | | `release_date` або `first_air_date` | рядки фільмів або серіалів | Ключ сортування, може бути порожнім | | `character` | акторський склад | Назва ролі | | `job`, `department` | знімальна група | Наприклад, `Director` у `Directing` | | `credit_id` | обидва | Id рядка ролі | Сортуйте за датою, рядки без дати ставте в кінець і прибирайте дублікати за парою `id` і `media_type`. Рядки акторського складу серіалів містять `episode_count`, але amodb повертає там `0`, тож не використовуйте його для підрахунку серій. amodb не надає `GET /3/credit/{credit_id}` чи `aggregate_credits`. Деталі полів акторського складу та знімальної групи описано на сторінці [акторський склад і знімальна група](https://amodb.dev/uk/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` описано на сторінці [API зображень](https://amodb.dev/uk/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 name id з персоною. Читайте `person_results` у відповіді. Дивіться [пошук за зовнішнім ID](https://amodb.dev/uk/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 запитів на хвилину, і кожен повертає всі ендпоінти people. Сітка акторів фільму коштує один запит credits, бо імена й шляхи до фото приходять разом, а сторінка персони коштує один запит із доданими credits. Оберіть ліміт, який відповідає вашим переглядам сторінок. Безкоштовного тарифу немає. Почніть зі сторінки [ціни](https://amodb.dev/uk/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 name id? Викличте GET /3/find/{external_id}?external_source=imdb_id і прочитайте person_results. Запис персони також повертає imdb_id, тож обидва id можна зберігати поруч і шукати в обидва боки. ### Чи доступні біографії іншими мовами? Так, через параметр language, для 14 підтримуваних мов. Ім'я відповідає вашій мові, якщо переклад існує. Якщо перекладу біографії немає, запис персони повертає англійський текст. ## Пов'язані сторінки - [API деталей персони](https://amodb.dev/uk/people/): API деталей персони з тими самими шляхами та JSON, що в TMDB v3. Отримайте актора чи режисера за id: біографія, фільмографія, зовнішні id і список популярних. - [API акторського складу та знімальної групи](https://amodb.dev/uk/credits/): API credits зі шляхами та JSON, як у TMDB v3. Отримайте акторський склад і знімальну групу фільмів, серіалів, сезонів і серій з полями order, department і job. - [API зображень і хост зображень](https://amodb.dev/uk/images-api/): API зображень фільмів зі шляхами TMDB v3: списки постерів, фонів, логотипів і кадрів проєкту, а потім завантаження з img.amodb.dev у 10 розмірах без ключа. - [API пошуку](https://amodb.dev/uk/search/): API пошуку з тими самими шляхами та JSON, що в TMDB v3. Шукайте фільми, серіали, персон, колекції, компанії та ключові слова за текстом, з фільтром за роком. - [Пошук за зовнішнім ID](https://amodb.dev/uk/find-by-external-id/): Знайдіть фільм, серіал чи персону за id IMDb, TVDB, Wikidata або Kinopoisk через find TMDB, а також прочитайте зовнішні id і факти Wikidata про проєкт. - [Швидкий старт](https://amodb.dev/uk/quickstart/): Перший виклик amodb: отримайте ключ, запросіть деталі фільму в curl, JavaScript, Python, PHP чи Go і завантажте постер з img.amodb.dev. Менш ніж за 2 хвилини. Оновлено: 2026-10-18. Source: https://amodb.dev/uk/actor-api/