Вземете API ключ

API за участниците

Ендпойнтите за участници връщат актьорския състав и екипа на филм на GET /3/movie/{movie_id}/credits, а също на сериали, сезони и епизоди под /3/tv. JSON съвпада с TMDB v3, включително credit_id, order, department и job. Епизодът добавя масива guest_stars до crew, а масивът cast е празен.

Обновено Отвори като Markdown

Участници във филм

GET /3/movie/{movie_id}/credits връща два масива за един филм: cast за хората, които се появяват на екрана, и crew за тези, които са работили зад камерата. Всеки запис съдържа id на личността, така че можете да отворите пълния запис на страницата личности. Същите данни има и в отговора за филма с append_to_response=credits.

Примерът чете Inception, отпечатва режисьора и изброява петимата първи актьори от списъка.

bashjspyphpgo 
curl -sSf "https://api.amodb.dev/3/movie/27205/credits?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
const url = 'https://api.amodb.dev/3/movie/27205/credits?language=en-US';
const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` } });
if (!res.ok) throw new Error(`amodb returned ${res.status}`);
const credits = await res.json();
const director = credits.crew.find((c) => c.job === 'Director');
console.log('Director:', director?.name);
for (const c of [...credits.cast].sort((a, b) => a.order - b.order).slice(0, 5)) {
  console.log(c.order, c.name, 'as', c.character);
}
import os
import requests

r = requests.get(
    "https://api.amodb.dev/3/movie/27205/credits",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
r.raise_for_status()
credits = r.json()
director = next((c for c in credits["crew"] if c["job"] == "Director"), None)
print("Director:", director and director["name"])
for c in sorted(credits["cast"], key=lambda c: c["order"])[:5]:
    print(c["order"], c["name"], "as", c["character"])
<?php
$url = 'https://api.amodb.dev/3/movie/27205/credits?language=en-US';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AMODB_KEY')],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status !== 200) {
    throw new RuntimeException("amodb returned $status");
}
$credits = json_decode($body, true);
usort($credits['cast'], fn ($a, $b) => $a['order'] <=> $b['order']);
foreach (array_slice($credits['cast'], 0, 5) as $c) {
    echo $c['order'], ' ', $c['name'], ' as ', $c['character'], PHP_EOL;
}
package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
	"time"
)

type Credits struct {
	Cast []struct {
		Order     int    `json:"order"`
		Name      string `json:"name"`
		Character string `json:"character"`
	} `json:"cast"`
	Crew []struct {
		Name string `json:"name"`
		Job  string `json:"job"`
	} `json:"crew"`
}

func main() {
	req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/movie/27205/credits?language=en-US", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))
	client := &http.Client{Timeout: 10 * time.Second}
	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		panic(res.Status)
	}
	var c Credits
	if err := json.NewDecoder(res.Body).Decode(&c); err != nil {
		panic(err)
	}
	for _, m := range c.Crew {
		if m.Job == "Director" {
			fmt.Println("Director:", m.Name)
		}
	}
	for i, a := range c.Cast {
		if i == 5 {
			break
		}
		fmt.Println(a.Order, a.Name, "as", a.Character)
	}
}

Параметри

  • movie_idпътзадължителен
    Числов id на филма, например 27205.
  • api_keyзаявкаедин от двата
    Вашият ключ. Ползвайте него или заглавката Authorization: Bearer.
  • languageзаявка
    Таг на TMDB, например en-US или fr-FR. Таговете извън 14-те основни езика се заменят с en.

Полета на отговора

ПолеКъде се прилагаБележки
idнай-горно нивоId на филма, сериала, сезона или епизода, към който принадлежат участниците.
cast, crewнай-горно нивоМасиви със записи. При епизод се добавя guest_stars.
idвсеки записId на личността. Отворете го през личности.
name, original_nameвсеки записИмето на личността.
known_for_departmentвсеки записОсновната работа на личността като цяло, а не ролята в това заглавие.
gender, popularity, adultвсеки записСъщото значение като в записа на личността.
profile_pathвсеки записПът до изображение или null. Добавя се към https://img.amodb.dev/t/p/{size}.
credit_idвсеки записНиз, който идентифицира точно този запис за участие.
charactercast, гостуващи звездиИме на ролята, при някои записи е празно.
ordercast, гостуващи звездиМясто в списъка, 0 е първото.
departmentcrewГрупа като Directing, Writing, Production, Camera, Editing, Sound, Art, Visual Effects, Lighting, Costume & Make-Up или Crew.
jobcrewКонкретна длъжност, например Director, Screenplay или Editor.

Примерен отговор

GET /3/movie/27205/credits?language=en-US. Днес отговорът съдържа 52 записа в cast и 735 в crew, затова тук и двата масива са съкратени до два:

JSON 
{
  "id": 27205,
  "cast": [
    {
      "adult": false,
      "gender": 2,
      "id": 6193,
      "known_for_department": "Acting",
      "name": "Leonardo DiCaprio",
      "original_name": "Leonardo DiCaprio",
      "popularity": 9.3213,
      "profile_path": "/wo2hJpn04vbtmh0B9utCFdsQhxM.jpg",
      "character": "Dom Cobb",
      "credit_id": "52fe4534c3a368484e04de03",
      "order": 0
    },
    {
      "adult": false,
      "gender": 2,
      "id": 24045,
      "known_for_department": "Acting",
      "name": "Joseph Gordon-Levitt",
      "original_name": "Joseph Gordon-Levitt",
      "popularity": 5.6202,
      "profile_path": "/z2FA8js799xqtfiFjBTicFYdfk.jpg",
      "character": "Arthur",
      "credit_id": "52fe4534c3a368484e04de0b",
      "order": 1
    }
  ],
  "crew": [
    {
      "adult": false,
      "gender": 2,
      "id": 1025090,
      "known_for_department": "Crew",
      "name": "Jim Wilkey",
      "original_name": "Jim Wilkey",
      "popularity": 0.9114,
      "profile_path": "/peEdS7ZYHwEeMJAwInJj732AeYs.jpg",
      "credit_id": "6634553bad59b501286dab5f",
      "department": "Crew",
      "job": "Stunt Driver"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 1741194,
      "known_for_department": "Sound",
      "name": "James Thatcher",
      "original_name": "James Thatcher",
      "popularity": 0.6215,
      "profile_path": null,
      "credit_id": "5bcdece8925141613e0216d3",
      "department": "Sound",
      "job": "Musician"
    }
  ]
}

Участници в сериали, сезони и епизоди

Всички пътища по-долу имат обща основа https://api.amodb.dev/3 и приемат language.

Метод и пътКакво връща
GET /tv/{series_id}/creditsАктьорски състав и екип на сериала, по един запис за човек и роля.
GET /tv/{series_id}/season/{season_number}/creditsАктьорски състав и екип на един сезон.
GET /tv/{series_id}/season/{season_number}/episode/{episode_number}/creditscrew и guest_stars за един епизод. cast е празен масив.

Същите данни се получават с append_to_response=credits на пътищата за сериал, сезон и епизод. Формата на записа е като при участниците във филм по-горе. Гостуващите звезди в епизод имат character и order, а записите в crew имат department и job.

GET /3/tv/1399/season/1/episode/1/credits?language=en-US, с масиви, съкратени до два записа:

JSON 
{
  "id": 63056,
  "cast": [],
  "crew": [
    {
      "department": "Writing",
      "job": "Writer",
      "credit_id": "5256c8a019c2956ff6046e2b",
      "adult": false,
      "gender": 2,
      "id": 9813,
      "known_for_department": "Writing",
      "name": "David Benioff",
      "original_name": "David Benioff",
      "popularity": 2.0354,
      "profile_path": "/xvNN5huL0X8yJ7h3IZfGG4O2zBD.jpg"
    },
    {
      "department": "Editing",
      "job": "Editor",
      "credit_id": "54eef2ab925141795f005d4f",
      "adult": false,
      "gender": 2,
      "id": 18077,
      "known_for_department": "Editing",
      "name": "Oral Norrie Ottey",
      "original_name": "Oral Norrie Ottey",
      "popularity": 0,
      "profile_path": null
    }
  ],
  "guest_stars": [
    {
      "character": "Benjen Stark",
      "credit_id": "5256c8b919c2956ff604836a",
      "order": 61,
      "adult": false,
      "gender": 2,
      "id": 119783,
      "known_for_department": "Acting",
      "name": "Joseph Mawle",
      "original_name": "Joseph Mawle",
      "popularity": 1.4645,
      "profile_path": "/1Ocb9v3h54beGVoJMm4w50UQhLf.jpg"
    },
    {
      "character": "Rickon Stark",
      "credit_id": "566a83bcc3a3683f56003604",
      "order": 80,
      "adult": false,
      "gender": 2,
      "id": 1050248,
      "known_for_department": "Acting",
      "name": "Art Parkinson",
      "original_name": "Art Parkinson",
      "popularity": 1.2594,
      "profile_path": "/ejAKOJME1DsvHECLWdQ7dEtXyyc.jpg"
    }
  ]
}

amodb не предлага обобщени участници за сериали и търсене по credit_id. За списък с актьорите на сериал четете /tv/{series_id}/credits и сортирайте cast по order.

Как да ползвате актьорите и екипа в приложение

ЗадачаКак
Показване на режисьораИзберете записите в crew, при които job е Director. Един филм може да има няколко.
Показване на главните актьориСортирайте cast по order и вземете първите 10.
Групиране на екипаГрупирайте по department. Човек с две длъжности се появява два пъти, затова обединете записите по id на личността.
Показване на актьорите на сериалПрочетете участниците в сериала и сортирайте cast по order.
Списък на всички отдели и длъжностиПолзвайте справочния списък, описан на страницата жанрове и справочни списъци.

Грешки

HTTPstatus_codeКога
4017Ключът липсва или е грешен.
40236Периодът на плана е изтекъл.
40434Филмът, сериалът, сезонът или епизодът не съществува, или пътят не се предлага.
40537Извикали сте метод за запис.
42925Надхвърлен е лимитът на заявки в минута. Изчакайте Retry-After секунди.

Подробности има на страниците грешки и лимити на заявките.

Практически бележки

  • Участниците се кешират за 6 часа, както и детайлите. Нов член на актьорския състав може да се появи едва след толкова време.
  • Голяма продукция може да изброява стотици записи в crew. Отрежете масивите, преди да ги покажете.
  • profile_path е null за хора без снимка. Ползвайте w185 за редове в списък и h632 за изгледи с детайли.
  • Записите за филми и сериали са на страниците филми и сериали. Записите за сезони и епизоди са на страницата сезони и епизоди.