# Alternativa k API TheTVDB > TheTVDB se zaměřuje na seriály a nabízí několik řazení epizod, například podle vysílání, DVD a absolutní. amodb pokrývá seriály, filmy i osoby jedním klíčem a TVDB ID mapuje na vlastní ID jedním voláním. Skupiny epizod seriálu vypisuje, ne však jejich obsah, alternativní číslování proto zůstává na TheTVDB. ## Který se hodí pro projekt o seriálech TheTVDB se zaměřuje na seriály a drží několik řazení epizod seriálu, včetně vysílacího, podle DVD a absolutního, za modelem klíče API. Než naplánujete komerční produkt, ověřte si v jejich dokumentaci licencování. Zvolte amodb, když chcete seriály, filmy a osoby z jednoho klíče, cesty TMDB v3 a 14 jazyků. Zvolte TheTVDB, když je přesné alternativní číslování středem vaší aplikace, protože amodb skupiny epizod seriálu vypisuje, ale neposkytuje, co je uvnitř nich. ## Jak se data seriálů mapují mezi oběma Pojmy si odpovídají, ale názvy se liší. Tato tabulka pokrývá, co aplikace o seriálech obvykle čte. | Potřeba | Přístup TheTVDB | Volání amodb | | ----------------------------- | -------------------------------------- | ---------------------------------------------------- | | Jeden seriál | Záznam seriálu podle ID z TVDB | `GET /3/tv/1396`, po vyhledání `tvdb_id` | | Seznam sezón | Podívejte se do jejich dokumentace | Pole `seasons` v detailech seriálu | | Jedna sezóna s epizodami | Podívejte se do jejich dokumentace | `GET /3/tv/1396/season/1` | | Jedna epizoda | Podívejte se do jejich dokumentace | `GET /3/tv/1396/season/1/episode/1` | | Která řazení existují | Řazení podle vysílání, DVD a absolutní | `GET /3/tv/1396/episode_groups` | | Epizody uvnitř jednoho řazení | Podívejte se do jejich dokumentace | Nenabízí se, `/3/tv/episode_group/{id}` odpovídá 404 | | Další epizoda ve vysílání | Podívejte se do jejich dokumentace | `next_episode_to_air` v detailech seriálu | Pole epizod používají názvy TMDB: `air_date`, `episode_number`, `season_number`, `runtime` a `still_path`. `external_ids` sezón a epizod jsou všechna null, ID z TVDB jedné sezóny nebo epizody proto z amodb přečíst nelze. Spojujte místo toho přes `season_number` a `episode_number`. Podrobnosti jsou na stránce [sezóny a epizody](https://amodb.dev/cs/tv-seasons-episodes/). ## Co vrací seznam skupin epizod Volání seznamu ukazuje, která řazení pro seriál existují. Epizody uvnitř nich nevrací. | Pole | Význam | | --------------- | ----------------------------------------- | | `id` | ID skupiny, řetězec | | `name` | Název řazení, například `DVD / PVOD` | | `description` | Text ze zdroje, často prázdný | | `type` | Číslo, které říká, o jaký druh řazení jde | | `episode_count` | Epizody v řazení | | `group_count` | Bloky v řazení, například sezóny | | `network` | Objekt se sítí, nebo null | Toto je skutečná odpověď pro Breaking Bad. ```json { "id": 1396, "results": [ { "description": "Seasons grouped as they appear on DVD, as well as paid video-on-demand services, such as Prime Video and YouTube.", "episode_count": 62, "group_count": 6, "id": "69f50757054263b7bc87e32a", "name": "DVD / PVOD", "network": null, "type": 3 } ] } ``` Některé seriály vracejí jedno vysílací řazení a jiné několik a některé vracejí prázdné pole `results`. Vyzkoušejte seriály, na kterých vám záleží. Protože se obsah skupiny nenabízí, aplikace, která potřebuje číslo každé epizody podle DVD nebo absolutní, ho z amodb nezíská. ## Srovnání funkcí | Funkce | TheTVDB | amodb | | --------------- | --------------------------------------------------- | ---------------------------------------------------------- | | Cenový model | Model klíče API, licencování viz jejich dokumentace | Předplacená období 1 až 24 měsíců | | Bezplatný tarif | Podívejte se do jejich dokumentace | Žádný, ani zkušební verze | | Ověření | Klíč API, postup viz jejich dokumentace | `api_key` nebo hlavička Bearer | | Formát odpovědi | JSON, podívejte se do jejich dokumentace | JSON ve tvaru TMDB v3 | | Jazyky | Podívejte se do jejich dokumentace | 14 jazyků rozhraní | | Filmy | Podívejte se do jejich dokumentace | Ano | | Seriály | Ano, hlavní zaměření | Ano, se sezónami a epizodami | | Osoby | Podívejte se do jejich dokumentace | Ano | | Obrázky | Podívejte se do jejich dokumentace | `img.amodb.dev`, klíč není potřeba | | Hodnocení | Podívejte se do jejich dokumentace | IMDb a čtyři další zdroje, kde jsou známé | | Limit požadavků | Podívejte se do jejich dokumentace | 20, 40 nebo 120 za minutu na klíč | | Komerční užití | Licencování viz jejich dokumentace | Placené tarify, viz [ceník](https://amodb.dev/cs/pricing/) | | Kompatibilita | Vlastní API | Čtení TMDB v3 a OMDb | ## V čem se amodb liší - **Jeden klíč pro celý katalog.** Seriál, jeho obsazení, trailery a film, který sdílí herce, používají stejnou základní URL a stejný limit. - **Hodnocení vedle průvodce epizodami.** `append_to_response=ratings` v detailech seriálu přidá IMDb a další skóre jedním voláním. - **Prosté hlavičky pro tempo.** `X-RateLimit-Remaining` a `X-RateLimit-Reset` řeknou synchronizační úloze, kolik požadavků zbývá v okně 60 sekund. - **Zachované původní názvy.** Seriál si ponechává `original_name`, zatímco `name` se řídí vaším `language`, což pomáhá, když zobrazujete původní titul. ## Kdy se TheTVDB hodí lépe - **Řazení je produkt.** Pokud se vaši uživatelé přou o řazení podle DVD, vysílání a absolutní, TheTVDB to bere jako jádro svého modelu. amodb řazení seriálu pojmenuje, ale jejich epizody nevrací a které skupiny existují, se liší podle seriálu. - **Stávající integrace.** Pokud váš pipeline už ukládá ID z TheTVDB a čte jeho řazení, ponechte tuto část a amodb přidejte pro další data. - **Zaměření na seriály.** Pokud nikdy nezobrazujete filmy ani osoby, zdroj postavený kolem seriálů má méně k naučení. ## Přechod na amodb ID z TVDB, která ukládáte, namapujte jednou. Poté používejte ID amodb pro každé volání. Endpoint find převádí jen ID seriálů. Jeho pole `tv_season_results` a `tv_episode_results` jsou vždy prázdná, sezóny a epizody proto mapujte podle čísla. ```js const key = process.env.AMODB_KEY; const headers = { Authorization: `Bearer ${key}` }; const base = 'https://api.amodb.dev/3'; async function getJson(path) { const res = await fetch(`${base}${path}`, { headers }); if (!res.ok) throw new Error(`${path} returned ${res.status}`); return res.json(); } const found = await getJson('/find/81189?external_source=tvdb_id'); const show = found.tv_results[0]; console.log(show.id, show.name); const groups = await getJson(`/tv/${show.id}/episode_groups`); for (const g of groups.results) { console.log(g.name, g.type, g.episode_count); } ``` První požadavek vrátí Breaking Bad s ID 1396. Druhý vypíše řazení, která pro tento seriál existují, s jejich velikostmi. Chcete-li porovnat číslování s tím, co ukládáte nyní, přečtěte vysílací pořadí z `/tv/{id}/season/{n}` a případné alternativní pořadí ponechte na straně TheTVDB. Tuto kontrolu proveďte u deseti nejsledovanějších seriálů, než přesunete zbytek. Každé volání se počítá jako jeden požadavek v okně 60 sekund a 429 nese `Retry-After`. Viz [hledání podle externího ID](https://amodb.dev/cs/find-by-external-id/) a [limity požadavků](https://amodb.dev/cs/rate-limits/). ## Ceník amodb je předplacené bez automatického obnovení. Zvolte 1, 3, 6, 12 nebo 24 měsíců a jeden ze tří tarifů s 20, 40 nebo 120 požadavky za minutu. Delší období mají slevu 10, 20, 30 nebo 40 procent a každý tarif dostane všechna data. Bezplatný tarif neexistuje. Částky jsou na stránce [ceník](https://amodb.dev/cs/pricing/). ## Otázky a odpovědi ### Mohu převést ID z TVDB na ID amodb? Ano. Zavolejte /3/find/81189 s external_source=tvdb_id. Pole tv_results obsahuje odpovídající seriál, takže Breaking Bad se vrátí s ID 1396. Dvojici uložte a od té chvíle používejte číselné ID. Funguje to i opačně: /3/tv/1396/external_ids vrací tvdb_id. ### Podporuje amodb řazení epizod podle DVD a absolutní? Jen částečně. GET /3/tv/{id}/episode_groups vypíše skupiny seriálu s name, type, episode_count a group_count. Obsah skupiny se nenabízí a /3/tv/episode_group/{id} odpovídá 404. Vidíte, že řazení podle DVD existuje, ale jeho číslování přečíst nelze. ### Je TheTVDB zdarma? TheTVDB používá model klíče API a licenční podmínky určuje TheTVDB. Aktuální licenci a případné poplatky si ověřte v jejich dokumentaci. amodb je předplacené placené API bez bezplatného tarifu. ### Dostanu i data filmů? Ano. Filmy, osoby, obrázky, videa a překlady jsou na stejném klíči a základní URL jako seriály. Odpadá tak potřeba druhého poskytovatele, pokud vaše aplikace uvádí obojí. ### Jak zjistím, která epizoda se vysílá příště? Detaily seriálu obsahují next_episode_to_air a last_episode_to_air, každé se season_number, episode_number a air_date. Další je u skončeného seriálu null. Detaily se na edge cachují 6 hodin, dotazujte se proto nejvýše několikrát denně. ## Související stránky - [API sezón a epizod seriálů](https://amodb.dev/cs/tv-seasons-episodes/): API sezón a epizod seriálů se stejnými cestami a JSON jako TMDB v3. Načtěte sezónu se všemi epizodami nebo jednu epizodu s datem vysílání, délkou a záběrem. - [Hledání podle externího ID](https://amodb.dev/cs/find-by-external-id/): Najděte film, seriál nebo osobu podle ID z IMDb, TVDB, Wikidata nebo Kinopoisk přes endpoint find TMDB a čtěte externí ID a fakta z Wikidata o titulu. - [API průvodce epizodami](https://amodb.dev/cs/episode-guide-api/): API průvodce epizodami s endpointy sezón a epizod TMDB v3: názvy, data vysílání, délky, záběry a seznamy skupin epizod pro libovolný seriál ve 14 jazycích. - [API detailu seriálu](https://amodb.dev/cs/tv-series/): API detailu seriálu se stejnými cestami a JSON jako TMDB v3. Seriál podle ID se sezónami, sítěmi, věkovým hodnocením a poskytovateli streamování. - [Rychlý start](https://amodb.dev/cs/quickstart/): První volání amodb: získejte klíč, vyžádejte detail filmu v curl, JavaScriptu, Pythonu, PHP nebo Go a načtěte plakát z img.amodb.dev. Za méně než 2 minuty. - [Limity požadavků](https://amodb.dev/cs/rate-limits/): amodb omezuje klíč počtem požadavků za minutu v klouzavém okně 60 sekund: 20, 40 nebo 120 podle tarifu. Čtěte hlavičky limitu a řešte 429 pomocí Retry-After. Aktualizováno: 2026-10-18. Source: https://amodb.dev/cs/thetvdb-api-alternative/