API акцёраў

API акцёраў гэта сямейства эндпоінтаў людзей 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 радкоў 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. Падрабязнасці пра палі акцёраў і групы ёсць на старонцы удзельнікі.

Фота профілю

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 ёсць на старонцы выявы.

Папулярныя людзі, пошук і пошук па 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 у адказе. Гл. пошук па вонкавым ідэнтыфікатары.

Параўнанне

Магчымасць	Уласны скрэйпінг старонак	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 запытаў у хвіліну, і кожны вяртае ўсе эндпоінты людзей. Сетка акцёраў фільма каштуе адзін запыт удзельнікаў, бо імёны і шляхі профілю ідуць разам з ім, а старонка персоны каштуе адзін запыт з далучанымі ўдзеламі. Абярыце частату, якая адпавядае вашым праглядам старонак. Бясплатнага тарыфа няма. Пачніце са старонкі цэны.

Пытанні і адказы

Як атрымаць усе фільмы і серыялы, дзе здымаўся акцёр?

Выклічце 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 падтрымліваных моў. Імя адпавядае вашай мове, калі пераклад існуе. Калі ў біяграфіі няма перакладу, запіс персоны вяртае англійскі тэкст.

Абноўлена 18 кас 2026 г.

Адкрыць у Markdown