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 са на страницата изображения.

Как се сравнява

Възможност	Сами да обработвате страници	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.10.2026 г.

Отвори като Markdown

Започнете с един ключ

Всеки план дава достъп до едни и същи данни, всички 14 езика и изображенията. Плановете се различават по броя заявки в минута, а Pro+ получава и /3/all: всичко за филм, сериал или личност в една заявка.

от 3,11 щ.д. на месец