# API sezoane și episoade TV > Citește un sezon cu fiecare episod la GET /3/tv/{series_id}/season/{season_number} sau un singur episod cu un nivel mai adânc. JSON-ul se potrivește cu TMDB v3 cu air_date, episode_number, runtime și still_path. Fiecare episod poartă crew și guest_stars, sezonul 0 conține episoadele speciale, iar append_to_response adaugă credite, imagini și videoclipuri. ## Endpoint `GET /3/tv/{series_id}/season/{season_number}` ```bash curl "https://api.amodb.dev/3/tv/1396/season/1?language=en-US" \ -H "Authorization: Bearer $AMODB_KEY" ``` Răspuns: ```json { "air_date": "2008-01-20", "episodes": [ { "air_date": "2008-01-20", "episode_number": 1, "episode_type": "standard", "id": 62085, "name": "Pilot", "overview": "When an unassuming high school chemistry teacher discovers he has a rare form of lung cancer, he decides to team up with a former student and create a top of the line crystal meth in a used RV, to provide for his family once he is gone.", "production_code": "", "runtime": 59, "season_number": 1, "show_id": 1396, "still_path": "/ydlY3iPfeOAvu8gVqrxPoMvzNCn.jpg", "vote_average": 0, "vote_count": 0, "crew": [ { "department": "Camera", "job": "Director of Photography", "credit_id": "52b7029219c29533d00dd2c1", "adult": false, "gender": 2, "id": 2483, "known_for_department": "Camera", "name": "约翰·托尔", "original_name": "约翰·托尔", "popularity": 1.1957, "profile_path": "/cfL9A6tC7L5Ps5fq1o3WpVKGMb1.jpg" }, { "department": "Directing", "job": "Director", "credit_id": "52542275760ee313280006e8", "adult": false, "gender": 2, "id": 66633, "known_for_department": "Writing", "name": "文斯·吉利根", "original_name": "文斯·吉利根", "popularity": 2.7786, "profile_path": "/wJIxATESjzsjSgvRhVavOmdamXc.jpg" }, { "department": "Writing", "job": "Writer", "credit_id": "52542275760ee313280006ce", "adult": false, "gender": 2, "id": 66633, "known_for_department": "Writing", "name": "文斯·吉利根", "original_name": "文斯·吉利根", "popularity": 2.7786, "profile_path": "/wJIxATESjzsjSgvRhVavOmdamXc.jpg" } ], "guest_stars": [ { "character": "Steven Gomez", "credit_id": "5271b489760ee35b3e0881a7", "order": 8, "adult": false, "gender": 2, "id": 61535, "known_for_department": "Acting", "name": "史蒂文·迈克尔·奎扎达", "original_name": "史蒂文·迈克尔·奎扎达", "popularity": 1.7511, "profile_path": "/pVYrDkwI6GWvCNL2kJhpDJfBFyd.jpg" }, { "character": "Jock", "credit_id": "52542275760ee313280006b4", "order": 500, "adult": false, "gender": 2, "id": 1216132, "known_for_department": "Acting", "name": "Aaron Hill", "original_name": "Aaron Hill", "popularity": 1.6521, "profile_path": "/rNp31SeoVqSQU6OZWxZUhGwAgyq.jpg" }, { "character": "Dr. Belknap", "credit_id": "52725cb1760ee3044d0b9984", "order": 502, "adult": false, "gender": 2, "id": 161591, "known_for_department": "Acting", "name": "Gregory Chase", "original_name": "Gregory Chase", "popularity": 0.5435, "profile_path": "/gNdodev00CROpXuAh5EFmkWTVOo.jpg" } ] }, { "air_date": "2008-01-27", "episode_number": 2, "episode_type": "standard", "id": 62086, "name": "Cat's in the Bag...", "overview": "Walt and Jesse attempt to tie up loose ends. The desperate situation gets more complicated with the flip of a coin. Walt's wife, Skyler, becomes suspicious of Walt's strange behavior.", "production_code": "", "runtime": 49, "season_number": 1, "show_id": 1396, "still_path": "/AbMoecO0ZZio0LcgeLxlzdyGs6X.jpg", "vote_average": 0, "vote_count": 0, "crew": [ { "department": "Camera", "job": "Director of Photography", "credit_id": "52b7049c19c2953b63015013", "adult": false, "gender": 2, "id": 17948, "known_for_department": "Camera", "name": "Reynaldo Villalobos", "original_name": "Reynaldo Villalobos", "popularity": 0.904, "profile_path": "/4YlfhHDRZWhbRgeqT2Bwl1u5p9j.jpg" }, { "department": "Writing", "job": "Writer", "credit_id": "52542275760ee313280006ce", "adult": false, "gender": 2, "id": 66633, "known_for_department": "Writing", "name": "文斯·吉利根", "original_name": "文斯·吉利根", "popularity": 2.7786, "profile_path": "/wJIxATESjzsjSgvRhVavOmdamXc.jpg" }, { "department": "Directing", "job": "Director", "credit_id": "52542275760ee31328000725", "adult": false, "gender": 2, "id": 111338, "known_for_department": "Directing", "name": "亚当·伯恩斯坦", "original_name": "亚当·伯恩斯坦", "popularity": 1.0511, "profile_path": "/mnob89jXPcPfW85PPw7tTPCKSig.jpg" } ], "guest_stars": [ { "character": "Krazy-8", "credit_id": "52725845760ee3046b09426e", "order": 504, "adult": false, "gender": 2, "id": 1046460, "known_for_department": "Acting", "name": "Max Arciniega", "original_name": "Max Arciniega", "popularity": 1.4399, "profile_path": "/eqKAJKPpt41KpsLIkkBnAY4HMAL.jpg" }, { "character": "Ob-Gyn", "credit_id": "63012c9c5f4b73008267ba53", "order": 682, "adult": false, "gender": 0, "id": 1448105, "known_for_department": "Acting", "name": "Shane Marinson", "original_name": "Shane Marinson", "popularity": 0, "profile_path": null }, { "character": "Ben", "credit_id": "63012d2111c066007cbc37b1", "order": 683, "adult": false, "gender": 0, "id": 3670897, "known_for_department": "Acting", "name": "Jason Byrd", "original_name": "Jason Byrd", "popularity": 0, "profile_path": null } ] }, { "air_date": "2008-02-10", "episode_number": 3, "episode_type": "standard", "id": 62087, "name": "...And the Bag's in the River", "overview": "Walter fights with Jesse over his drug use, causing him to leave Walter alone with their captive, Krazy-8. Meanwhile, Hank has a scared straight moment with Walter Jr. after his aunt discovers he has been smoking pot. Also, Skylar is upset...", "production_code": "", "runtime": 49, "season_number": 1, "show_id": 1396, "still_path": "/2kBeBlxGqBOdWlKwzAxiwkfU5on.jpg", "vote_average": 0, "vote_count": 0, "crew": [ { "department": "Camera", "job": "Director of Photography", "credit_id": "52b7049c19c2953b63015013", "adult": false, "gender": 2, "id": 17948, "known_for_department": "Camera", "name": "Reynaldo Villalobos", "original_name": "Reynaldo Villalobos", "popularity": 0.904, "profile_path": "/4YlfhHDRZWhbRgeqT2Bwl1u5p9j.jpg" }, { "department": "Writing", "job": "Writer", "credit_id": "52542275760ee313280006ce", "adult": false, "gender": 2, "id": 66633, "known_for_department": "Writing", "name": "文斯·吉利根", "original_name": "文斯·吉利根", "popularity": 2.7786, "profile_path": "/wJIxATESjzsjSgvRhVavOmdamXc.jpg" }, { "department": "Directing", "job": "Director", "credit_id": "52542275760ee31328000725", "adult": false, "gender": 2, "id": 111338, "known_for_department": "Directing", "name": "亚当·伯恩斯坦", "original_name": "亚当·伯恩斯坦", "popularity": 1.0511, "profile_path": "/mnob89jXPcPfW85PPw7tTPCKSig.jpg" } ], "guest_stars": [ { "character": "Steven Gomez", "credit_id": "5271b489760ee35b3e0881a7", "order": 8, "adult": false, "gender": 2, "id": 61535, "known_for_department": "Acting", "name": "史蒂文·迈克尔·奎扎达", "original_name": "史蒂文·迈克尔·奎扎达", "popularity": 1.7511, "profile_path": "/pVYrDkwI6GWvCNL2kJhpDJfBFyd.jpg" }, { "character": "Krazy-8", "credit_id": "52725845760ee3046b09426e", "order": 504, "adult": false, "gender": 2, "id": 1046460, "known_for_department": "Acting", "name": "Max Arciniega", "original_name": "Max Arciniega", "popularity": 1.4399, "profile_path": "/eqKAJKPpt41KpsLIkkBnAY4HMAL.jpg" }, { "character": "Carmen Molina", "credit_id": "52542273760ee31328000676", "order": 643, "adult": false, "gender": 1, "id": 115688, "known_for_department": "Acting", "name": "卡门·塞兰诺", "original_name": "卡门·塞兰诺", "popularity": 1.1342, "profile_path": "/nzJEe2UqvvMIBJZP1aeFEj4EunN.jpg" } ] } ], "name": "Season 1", "overview": "High school chemistry teacher Walter White's life is suddenly transformed by a dire medical diagnosis. Street-savvy former student Jesse Pinkman \"teaches\" Walter a new trade.", "id": 3572, "poster_path": "/91EIXdWxmp2mHNRsSuDW3WyDJLj.jpg", "season_number": 1, "vote_average": 0 } ``` ## Obține un sezon `GET /3/tv/{series_id}/season/{season_number}` întoarce un sezon și array-ul lui complet `episodes` într-un singur răspuns. Numerele de sezon încep de la `1`, iar `0` este rezervat pentru episoadele speciale. Ia ID-ul serialului și numerele de sezon din fișa [seriale TV](https://amodb.dev/ro/tv-series/). Exemplul citește sezonul 1 din Breaking Bad. Codul afișează câte o linie pe episod. ```bash curl -sSf "https://api.amodb.dev/3/tv/1396/season/1?language=en-US" \ -H "Authorization: Bearer $AMODB_KEY" ``` ```js const url = 'https://api.amodb.dev/3/tv/1396/season/1?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 season = await res.json(); for (const ep of season.episodes) { console.log(String(ep.episode_number).padStart(2, '0'), ep.name, ep.air_date, `${ep.runtime ?? '?'} min`); } ``` ```python import os import requests r = requests.get( "https://api.amodb.dev/3/tv/1396/season/1", params={"language": "en-US"}, headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"}, timeout=10, ) r.raise_for_status() season = r.json() for ep in season["episodes"]: print(f"{ep['episode_number']:02d}", ep["name"], ep["air_date"], ep["runtime"] or "?") ``` ```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"); } $season = json_decode($body, true); foreach ($season['episodes'] as $ep) { printf("%02d %s %s\n", $ep['episode_number'], $ep['name'], $ep['air_date']); } ``` ```go package main import ( "encoding/json" "fmt" "net/http" "os" "time" ) type Season struct { Name string `json:"name"` Episodes []struct { EpisodeNumber int `json:"episode_number"` Name string `json:"name"` AirDate string `json:"air_date"` Runtime int `json:"runtime"` } `json:"episodes"` } func main() { req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/tv/1396/season/1?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 s Season if err := json.NewDecoder(res.Body).Decode(&s); err != nil { panic(err) } for _, e := range s.Episodes { fmt.Printf("%02d %s %s %d min\n", e.EpisodeNumber, e.Name, e.AirDate, e.Runtime) } } ``` ### Parametri | Parametru | Loc | Obligatoriu | Descriere | | -------------------- | ---------- | -------------------- | ------------------------------------------------------------------------------------------------- | | `series_id` | cale | da | ID numeric de TV, de exemplu `1396`. | | `season_number` | cale | da | Număr întreg de sezon. `0` întoarce episoadele speciale. | | `api_key` | interogare | una dintre cele două | Cheia ta. Folosește-o pe aceasta sau antetul `Authorization: Bearer`. | | `language` | interogare | nu | Etichetă TMDB precum `en-US` sau `fr-FR`. Sunt servite 14 limbi de bază. Implicit `en-US`. | | `append_to_response` | interogare | nu | Valori la nivel de sezon: `credits`, `external_ids`, `images`, `videos`. Alte nume sunt ignorate. | ### Câmpurile răspunsului | Câmp | Tip | Observații | | --------------------- | ------------ | ------------------------------------------------------------ | | `id`, `season_number` | număr întreg | ID-ul sezonului și numărul lui în serial. | | `name`, `overview` | șir | Text localizat, gol când nu există traducere. | | `air_date` | șir sau null | Data primului episod, `YYYY-MM-DD`. | | `poster_path` | șir sau null | Se adaugă la `https://img.amodb.dev/t/p/{size}`. | | `vote_average` | număr | Scorul agregat al utilizatorilor pentru sezon. | | `episodes` | array | Fiecare episod, cu câmpurile listate în secțiunea următoare. | ### Exemplu de răspuns `GET /3/tv/1396/season/1?language=en-US`. Sezonul are 7 episoade, deci `episodes` este tăiat la o intrare, iar array-urile `crew` și `guest_stars` ale acelei intrări sunt omise: ```json { "air_date": "2008-01-20", "episodes": [ { "air_date": "2008-01-20", "episode_number": 1, "episode_type": "standard", "id": 62085, "name": "Pilot", "overview": "When an unassuming high school chemistry teacher discovers he has a rare form of lung cancer, he decides to...", "production_code": "", "runtime": 59, "season_number": 1, "show_id": 1396, "still_path": "/ydlY3iPfeOAvu8gVqrxPoMvzNCn.jpg", "vote_average": 0, "vote_count": 0 } ], "name": "Season 1", "overview": "High school chemistry teacher Walter White's life is suddenly transformed by a dire medical diagnosis. Stre...", "id": 3572, "poster_path": "/91EIXdWxmp2mHNRsSuDW3WyDJLj.jpg", "season_number": 1, "vote_average": 0 } ``` Fiecare episod din răspunsul de sezon poartă și array-urile `crew` și `guest_stars`, cu structura de intrare descrisă la [credite](https://amodb.dev/ro/credits/). `runtime` poate fi null pentru un episod nedifuzat. ## Obține un episod `GET /3/tv/{series_id}/season/{season_number}/episode/{episode_number}` întoarce un episod. Răspunsul de sezon conține deja fiecare episod cu `crew` și `guest_stars`, deci folosește acest endpoint ca să reîmprospătezi o singură înregistrare fără să reîncarci sezonul. Acceptă `language` și `append_to_response` cu `credits`, `external_ids`, `images`, `translations` și `videos`. O cerere precum `/3/tv/1396/season/1/episode/1?append_to_response=credits` costă o cerere. | Câmp | Tip | Observații | | --------------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | număr întreg | ID-ul episodului. | | `show_id` | număr întreg | ID-ul serialului. Prezent în răspunsul de sezon și în pointerii de serial, nu în răspunsul pentru un singur episod. | | `season_number`, `episode_number` | număr întreg | Poziția în serial. Folosește-le ca să construiești calea cererii. | | `name`, `overview` | șir | Text localizat. | | `air_date` | șir sau null | Doar data, fără oră sau fus orar. Null când nu e programat. | | `episode_type` | șir | `standard` pentru episoadele obișnuite. Ca să identifici un final, compară `episode_number` cu `episode_count` al acelui sezon din fișa serialului. | | `runtime` | număr întreg sau null | Minute. | | `production_code` | șir | Cod de studio, adesea gol. | | `still_path` | șir sau null | Cadrul episodului. Folosește `w300` sau `original` de la `https://img.amodb.dev/t/p/{size}`. | | `vote_average`, `vote_count` | număr, număr întreg | Scorul agregat al utilizatorilor. | | `crew`, `guest_stars` | array | Creditele acestui episod, vezi [credite](https://amodb.dev/ro/credits/). | ## Următorul și ultimul episod din fișa serialului Endpoint-ul de serial întoarce `next_episode_to_air` și `last_episode_to_air`. Fiecare este un rezumat de episod cu câmpurile de mai sus, plus `show_id` și fără `crew` și `guest_stars`. Următorul este null pentru serialele încheiate și pentru cele care revin fără o dată confirmată. Exemplul citește South Park, un serial care revine. ```js const headers = { Authorization: `Bearer ${process.env.AMODB_KEY}` }; const res = await fetch('https://api.amodb.dev/3/tv/2190', { headers }); if (!res.ok) throw new Error(`amodb returned ${res.status}`); const next = (await res.json()).next_episode_to_air; console.log(next ? `Next: S${next.season_number}E${next.episode_number} on ${next.air_date}` : 'No upcoming episode'); ``` Pentru o numărătoare inversă, compară `air_date` cu data locală a spectatorului. Valoarea nu poartă ora zilei, deci arată o dată și nu o oră de ceas. ## Sub-resurse de sezon și de episod Căile de sezon și de episod au propriile sub-resurse. Câteva dintre ele întorc azi date goale. | Metodă și cale | Întoarce | | --------------------------------------------------------- | ------------------------------------------------------------- | | `GET /tv/{series_id}/season/{season_number}/credits` | `id`, `cast` și `crew` pentru sezon | | `GET /tv/{series_id}/season/{season_number}/images` | `id` și un array `posters` gol | | `GET /tv/{series_id}/season/{season_number}/videos` | `id` și un array `results` gol | | `GET /tv/{series_id}/season/{season_number}/external_ids` | `id` plus `tvdb_id`, `wikidata_id` și alte ID-uri, toate null | | `GET /tv/{series_id}/season/{season_number}/translations` | `id` și un array `translations` gol | | `GET .../episode/{episode_number}/credits` | `id`, un `cast` gol, `crew` și `guest_stars` | | `GET .../episode/{episode_number}/images` | `id` și un array `stills` cu cadrul episodului | | `GET .../episode/{episode_number}/videos` | `id` și un array `results` gol | | `GET .../episode/{episode_number}/external_ids` | `id` plus `imdb_id`, `tvdb_id` și alte ID-uri, toate null | | `GET .../episode/{episode_number}/translations` | `id` și un array `translations` cu nume și descriere pe limbă | Creditele de sezon și de episod sunt tratate la [credite](https://amodb.dev/ro/credits/), iar cadrele la [imagini](https://amodb.dev/ro/images-api/). amodb nu oferă căile TMDB `changes` sau un endpoint pentru episoadele unui grup de episoade. ## Erori | HTTP | status_code | Când | | ---- | ----------- | -------------------------------------------------------------------------------------------------------------------------------- | | 401 | 7 | Cheia lipsește sau este greșită. | | 402 | 36 | Perioada planului s-a încheiat. | | 404 | 34 | Serialul, sezonul sau episodul nu există, de exemplu sezonul `0` la un serial fără episoade speciale, sau calea nu este oferită. | | 405 | 37 | Ai apelat o metodă de scriere. | | 429 | 25 | Ai depășit cererile pe minut. Așteaptă numărul de secunde din `Retry-After`. | Vezi [erori](https://amodb.dev/ro/errors/) pentru formatul complet al corpului și [limite de cereri](https://amodb.dev/ro/rate-limits/) pentru ferestre. ## Note practice - Sezoanele și episoadele sunt ținute în cache 6 ore. Recitește sezonul curent o dată sau de două ori pe zi cât timp se difuzează serialul. - Un serial cu 10 sezoane cere 10 apeluri de sezon. Pe planul de 20 de cereri pe minut asta folosește jumătate din alocarea unui minut, iar o rulare repetată în 6 ore este servită din cache-ul la margine. - Un episod nedifuzat poate avea `air_date` null, `runtime` null și `overview` gol. Afișează un substituent în loc să eșuezi. - Cadrele sunt imagini late, nu postere. Cere `w300` pentru liste și `original` doar când ai nevoie de o vizualizare la dimensiune completă. ## Întrebări și răspunsuri ### Cum listez fiecare episod al unui serial? Citește number_of_seasons din fișa serialului, apoi apelează endpoint-ul de sezon o dată pentru fiecare număr de sezon. Fiecare răspuns de sezon poartă array-ul complet episodes, deci un serial cu cinci sezoane cere cinci cereri. ### Ce înseamnă sezonul numărul 0? Sezonul 0 conține episoadele speciale, precum materiale din culise și rezumate. Există doar când serialul are episoade speciale, iar un serial fără ele întoarce 404 cu status_code 34 pentru sezonul 0. ### De ce este air_date null la unele episoade? Episodul este anunțat, dar nu are încă o dată confirmată. Tratează null ca neprogramat și verifică next_episode_to_air din fișa serialului pentru următorul episod datat. ### Pot obține o ordine DVD sau absolută a episoadelor? Nu ca listă separată. GET /3/tv/{series_id}/episode_groups numește ordinile pe care le are un serial, dar amodb nu oferă un endpoint care să întoarcă episoadele unui grup. Endpoint-ul de sezon dă ordinea standard. ## Pagini conexe - [API seriale TV](https://amodb.dev/ro/tv-series/): API seriale TV cu căile și JSON-ul TMDB v3. Preia un serial după ID cu sezoane, rețele și următorul episod, plus clasificări de conținut și furnizori. - [API credite](https://amodb.dev/ro/credits/): API credite cu aceleași căi și același JSON ca TMDB v3. Distribuția și echipa pentru filme, seriale, sezoane și episoade, cu order, department și job. - [API imagini și gazdă de imagini](https://amodb.dev/ro/images-api/): API imagini filme cu căi TMDB v3: listează postere, imagini de fundal, logouri și cadre, apoi încarcă-le de la img.amodb.dev în 10 dimensiuni, fără cheie. - [API ghid de episoade](https://amodb.dev/ro/episode-guide-api/): API ghid de episoade pe endpoint-urile TMDB v3: nume, date de difuzare, durate, cadre și liste de grupuri de episoade pentru orice serial, în 14 limbi. - [Limite de cereri](https://amodb.dev/ro/rate-limits/): amodb limitează fiecare cheie în cereri pe minut, în fereastră glisantă de 60 de secunde: 20, 40 sau 120. Citește antetele și tratează 429 cu Retry-After. - [Ghid rapid](https://amodb.dev/ro/quickstart/): Fă primul apel amodb: ia o cheie, cere detaliile unui film în curl, JavaScript, Python, PHP sau Go, apoi încarcă posterul de pe img.amodb.dev. Sub 2 minute. Actualizat: 2026-10-18. Source: https://amodb.dev/ro/tv-seasons-episodes/