# API obsady i ekipy > Endpointy credits zwracają obsadę i ekipę filmu pod GET /3/movie/{movie_id}/credits oraz seriali, sezonów i odcinków pod /3/tv. JSON odpowiada TMDB v3, w tym credit_id, order, department i job. Obsada odcinków dodaje obok crew tablicę guest_stars, a ich tablica cast jest pusta. ## Endpoint `GET /3/movie/{movie_id}/credits` ```bash curl "https://api.amodb.dev/3/movie/27205/credits?language=en-US" \ -H "Authorization: Bearer $AMODB_KEY" ``` Odpowiedź: ```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 }, { "adult": false, "gender": 2, "id": 3899, "known_for_department": "Acting", "name": "Ken Watanabe", "original_name": "Ken Watanabe", "popularity": 3.1459, "profile_path": "/psAXOYp9SBOXvg6AXzARDedNQ9P.jpg", "character": "Saito", "credit_id": "52fe4534c3a368484e04de07", "order": 2 } ], "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" }, { "adult": false, "gender": 2, "id": 1899036, "known_for_department": "Crew", "name": "Kyle Photo Bucher", "original_name": "Kyle Photo Bucher", "popularity": 0, "profile_path": null, "credit_id": "5bcdfa639251416134024237", "department": "Crew", "job": "Set Production Assistant" } ] } ``` ## Pobieranie obsady i ekipy filmu `GET /3/movie/{movie_id}/credits` zwraca dla jednego filmu dwie tablice: `cast` dla osób widocznych na ekranie i `crew` dla osób pracujących za kamerą. Każda pozycja zawiera ID osoby, więc pełny rekord otworzysz na stronie [osoby](https://amodb.dev/pl/people/). Te same dane są dostępne w odpowiedzi filmu z `append_to_response=credits`. Przykład odczytuje Inception, wypisuje reżysera i pięciu pierwszych aktorów z czołówki. ```bash curl -sSf "https://api.amodb.dev/3/movie/27205/credits?language=en-US" \ -H "Authorization: Bearer $AMODB_KEY" ``` ```js 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); } ``` ```python 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 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; } ``` ```go 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) } } ``` ### Parametry | Parametr | Gdzie | Wymagany | Opis | | ---------- | ----- | ------------- | ------------------------------------------------------------------------------------------ | | `movie_id` | path | tak | Numeryczne ID filmu, na przykład `27205`. | | `api_key` | query | jeden z dwóch | Twój klucz. Użyj go albo nagłówka `Authorization: Bearer`. | | `language` | query | nie | Tag TMDB, na przykład `en-US` lub `fr-FR`. Tagi spoza 14 języków bazowych wracają do `en`. | ### Pola odpowiedzi | Pole | Dotyczy | Uwagi | | ------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | najwyższy poziom | ID filmu, serialu, sezonu lub odcinka, do którego należy obsada. | | `cast`, `crew` | najwyższy poziom | Tablice pozycji. Obsada odcinków dodaje `guest_stars`. | | `id` | każda pozycja | ID osoby. Otwórz je przez [osoby](https://amodb.dev/pl/people/). | | `name`, `original_name` | każda pozycja | Imię i nazwisko osoby. | | `known_for_department` | każda pozycja | Główne zajęcie osoby ogółem, a nie funkcja w tym tytule. | | `gender`, `popularity`, `adult` | każda pozycja | Takie samo znaczenie jak w rekordzie osoby. | | `profile_path` | każda pozycja | Ścieżka obrazu lub null. Dołącz do `https://img.amodb.dev/t/p/{size}`. | | `credit_id` | każda pozycja | Ciąg identyfikujący ten jeden wpis. | | `character` | cast, gościnni aktorzy | Nazwa roli, w niektórych pozycjach pusta. | | `order` | cast, gościnni aktorzy | Pozycja w czołówce, `0` jest pierwsza. | | `department` | crew | Grupa taka jak `Directing`, `Writing`, `Production`, `Camera`, `Editing`, `Sound`, `Art`, `Visual Effects`, `Lighting`, `Costume & Make-Up` lub `Crew`. | | `job` | crew | Konkretna funkcja, na przykład `Director`, `Screenplay` lub `Editor`. | ### Przykładowa odpowiedź `GET /3/movie/27205/credits?language=en-US`. Odpowiedź ma dziś 52 pozycje cast i 735 pozycji crew, więc obie tablice są tu przycięte do dwóch: ```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" } ] } ``` ## Obsada seriali, sezonów i odcinków Wszystkie poniższe ścieżki mają wspólną bazę `https://api.amodb.dev/3` i przyjmują `language`. | Metoda i ścieżka | Zwraca | | ----------------------------------------------------------------------------- | ---------------------------------------------------------------- | | `GET /tv/{series_id}/credits` | Obsada i ekipa serialu, jedna pozycja na osobę i rolę. | | `GET /tv/{series_id}/season/{season_number}/credits` | Obsada i ekipa jednego sezonu. | | `GET /tv/{series_id}/season/{season_number}/episode/{episode_number}/credits` | `crew` i `guest_stars` jednego odcinka. `cast` to pusta tablica. | Te same dane są dostępne z `append_to_response=credits` na ścieżkach serialu, sezonu i odcinka. Kształt pozycji odpowiada obsadzie filmu powyżej. Gościnni aktorzy odcinków niosą `character` i `order`, a pozycje ekipy niosą `department` i `job`. `GET /3/tv/1399/season/1/episode/1/credits?language=en-US`, tablice przycięte do dwóch pozycji: ```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 nie udostępnia zbiorczej obsady seriali ani wyszukiwania po `credit_id`. Listę obsady serialu odczytaj z `/tv/{series_id}/credits` i posortuj `cast` według `order`. ## Odczyt obsady i ekipy w aplikacji | Zadanie | Jak | | ---------------------------------- | --------------------------------------------------------------------------------------------------- | | Pokazać reżysera | Wybierz pozycje `crew`, w których `job` to `Director`. Film może mieć kilku. | | Pokazać główną obsadę | Posortuj `cast` według `order` i weź pierwszych 10. | | Pogrupować ekipę | Grupuj według `department`. Osoba z dwiema funkcjami pojawia się dwa razy, więc scal po `id` osoby. | | Pokazać obsadę serialu | Odczytaj obsadę serialu i posortuj `cast` według `order`. | | Wypisać wszystkie działy i funkcje | Odczytaj słownik opisany na stronie [gatunki i słowniki](https://amodb.dev/pl/genres/). | ## Błędy | HTTP | status_code | Kiedy | | ---- | ----------- | ----------------------------------------------------------------------------------- | | 401 | 7 | Brakuje klucza lub jest błędny. | | 402 | 36 | Okres planu dobiegł końca. | | 404 | 34 | Film, serial, sezon lub odcinek nie istnieje albo ścieżka nie jest udostępniana. | | 405 | 37 | Wywołano metodę zapisu. | | 429 | 25 | Przekroczono limit żądań na minutę. Poczekaj tyle sekund, ile podaje `Retry-After`. | Szczegóły są na stronach [błędy](https://amodb.dev/pl/errors/) i [limity żądań](https://amodb.dev/pl/rate-limits/). ## Praktyczne uwagi - Obsada i ekipa są w cache przez 6 godzin, tak jak szczegóły. Nowy członek obsady może pojawić się dopiero po tym czasie. - Duża produkcja może mieć setki pozycji ekipy. Przytnij tablice przed renderowaniem. - `profile_path` ma wartość null u osób bez zdjęcia. Użyj `w185` dla wierszy list i `h632` dla widoków szczegółów. - Rekordy filmów i seriali są na stronach [filmy](https://amodb.dev/pl/movies/) i [seriale](https://amodb.dev/pl/tv-series/). Rekordy sezonów i odcinków są na stronie [sezony i odcinki](https://amodb.dev/pl/tv-seasons-episodes/). ## Pytania i odpowiedzi ### Jak pobrać listę obsady serialu? Wywołaj GET /3/tv/{series_id}/credits i posortuj tablicę cast według order. Obsada sezonu obejmuje jeden sezon, a obsada odcinka dodaje guest_stars. amodb nie udostępnia zbiorczej obsady seriali. ### Jak znaleźć reżysera filmu? Odczytaj tablicę crew i wybierz pozycję, w której job to Director. Film może mieć więcej niż jednego reżysera, więc zbieraj wszystkie dopasowania zamiast zatrzymywać się na pierwszym. ### Co oznacza pole order? Order to pozycja członka obsady w czołówce, gdzie 0 jest pierwsze. Posortuj obsadę według order, by najpierw pokazać główne role. Pozycje crew nie mają order. ### Skąd biorą się gościnni aktorzy? Tablicę guest_stars obok crew zwraca tylko endpoint obsady odcinka. Jego tablica cast jest pusta. Obsada sezonu i serialu nie wymienia gościnnych aktorów osobno. ## Powiązane strony - [API szczegółów osoby](https://amodb.dev/pl/people/): API szczegółów osoby z tymi samymi ścieżkami i JSON co TMDB v3. Aktor lub ekipa po ID z biografią, filmografią, zewnętrznymi ID i listą popularnych osób. - [API szczegółów filmu](https://amodb.dev/pl/movies/): API szczegółów filmu z tymi samymi ścieżkami i JSON co TMDB v3. Pobierz film po ID, dołącz obsadę, oceny i nastroje przez append_to_response, 14 języków. - [API szczegółów serialu](https://amodb.dev/pl/tv-series/): API szczegółów serialu z tymi samymi ścieżkami i JSON co TMDB v3. Serial po ID z sezonami, sieciami, klasyfikacją wiekową i dostawcami streamingu. - [API sezonów i odcinków seriali](https://amodb.dev/pl/tv-seasons-episodes/): API sezonów i odcinków seriali z tymi samymi ścieżkami i JSON co TMDB v3. Odczytaj sezon ze wszystkimi odcinkami albo jeden odcinek z datą emisji i kadrem. - [API aktorów](https://amodb.dev/pl/actor-api/): API aktorów na endpointach osób TMDB v3: biografia, pełna filmografia przez combined credits, zdjęcia profilowe i lista popularnych osób w 14 językach. - [Szybki start](https://amodb.dev/pl/quickstart/): Pierwsze wywołanie amodb: zdobądź klucz, pobierz szczegóły filmu w curl, JavaScript, Python, PHP lub Go, potem załaduj plakat z img.amodb.dev. Poniżej 2 minut. Zaktualizowano: 2026-10-18. Source: https://amodb.dev/pl/credits/