API акторів

API акторів це родина ендпоінтів people з TMDB v3 на api.amodb.dev/3. Отримайте персону через GET /3/person/{person_id}, додайте combined_credits для повної фільмографії та images для фото профілю. Список популярних, пошук за іменем і пошук за IMDb id працюють з тим самим ключем і тим самим форматом JSON.

Переглянути тарифи Відкрити швидкий старт

Запит

curl Python

bashpy

curl -s "https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits" \
  -H "Authorization: Bearer $AMODB_KEY"

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")

Відповідь 200

{
  "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",

Знайдіть актора та його фільмографію

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 кроки

Оберіть тариф на сторінці ціни. Усі тарифи повертають однакові дані та відрізняються лише кількістю запитів на хвилину.
Згенеруйте ключ у кабінеті акаунта.
Надішліть GET /3/person/31 із заголовком Authorization: Bearer YOUR_API_KEY або використайте api_key у рядку запиту.

Приклад запиту

Цей запит отримує Tom Hanks разом з усіма його ролями. Приклад на Python залишає ролі у фільмах із датою виходу, сортує їх від нових до старих, виводить п'ять із них та URL фото.

curl Python

bashpy

curl -s "https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits" \
  -H "Authorization: Bearer $AMODB_KEY"

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. Деталі полів акторського складу та знімальної групи описано на сторінці акторський склад і знімальна група.

Фото профілю

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 зображень.

Порівняння

Можливість	Скрапінг сторінок власноруч	Безкоштовний 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. Оберіть ліміт, який відповідає вашим переглядам сторінок. Безкоштовного тарифу немає. Почніть зі сторінки ціни.

Запитання та відповіді

Як отримати всі фільми й серіали, у яких знімався актор?

Викличте 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 підтримуваних мов. Ім'я відповідає вашій мові, якщо переклад існує. Якщо перекладу біографії немає, запис персони повертає англійський текст.

Оновлено 18 жовт. 2026 р.

Відкрити в Markdown

Почніть з одного ключа

Кожен тариф дає доступ до тих самих даних, усіх 14 мов і зображень. Тарифи відрізняються кількістю запитів на хвилину, а Pro+ отримує ще й /3/all: усе про фільм, серіал чи персону в одному запиті.

від 3,11 USD на місяць