# 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 людей, которые использует 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/ru/pricing/). Все тарифы возвращают одни и те же данные и различаются только числом запросов в минуту. 2. Создайте ключ в личном кабинете. 3. Отправьте `GET /3/person/31` с заголовком `Authorization: Bearer YOUR_API_KEY` или передайте `api_key` в строке запроса. ## Пример запроса Этот запрос получает Tom Hanks вместе с combined credits. Пример на 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/ru/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/ru/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/ru/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/ru/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 дней. ### Как сопоставить актера с именным id IMDb? Вызовите GET /3/find/{external_id}?external_source=imdb_id и прочитайте person_results. Запись человека тоже возвращает imdb_id, так что можно хранить оба id рядом и искать в любом направлении. ### Доступны ли биографии на других языках? Да, через параметр language, для 14 поддерживаемых языков. Имя следует вашему языку, если перевод существует. Если перевода биографии нет, запись человека возвращает английский текст. ## Связанные страницы - [API деталей человека](https://amodb.dev/ru/people/): API деталей человека с теми же путями и JSON, что в TMDB v3. Получайте актера или члена съемочной группы по ID: биография, фильмография, внешние ID, популярные. - [API актеров и съемочной группы](https://amodb.dev/ru/credits/): API credits с теми же путями и JSON, что в TMDB v3. Актерский состав и съемочная группа фильмов, сериалов, сезонов и серий с полями order, department, job. - [API изображений и хост изображений](https://amodb.dev/ru/images-api/): API изображений фильмов с путями TMDB v3: списки постеров, фонов, логотипов и кадров для каждого проекта, загрузка с img.amodb.dev в 10 размерах без ключа. - [API поиска](https://amodb.dev/ru/search/): API поиска с путями и JSON как в TMDB v3. Находите фильмы, сериалы, людей, коллекции, компании и ключевые слова по тексту, с фильтром по году и пагинацией. - [Поиск по внешнему ID](https://amodb.dev/ru/find-by-external-id/): Найдите фильм, сериал или персону по ID IMDb, TVDB, Wikidata или Kinopoisk через эндпоинт find TMDB, а также прочитайте внешние ID и факты Wikidata о проекте. - [Быстрый старт](https://amodb.dev/ru/quickstart/): Первый вызов amodb: получите ключ, запросите детали фильма через curl, JavaScript, Python, PHP или Go и загрузите постер с img.amodb.dev. Меньше 2 минут. Обновлено: 2026-10-18. Source: https://amodb.dev/ru/actor-api/