# amodb vs TMDB > amodb zachovává cesty, parametry dotazu a JSON TMDB v3 u většiny endpointů pro čtení, takže klient potřebuje novou základní URL a klíč. Zápisy odpovídají 405 a changes, aggregate credits a vyhledání recenzí se nenabízejí. Další rozdíly jsou podmínky, 14 jazyků, pět rozšíření a limity na klíč. ## Stručné srovnání amodb je nezávislé API, které mluví stejným protokolem jako TMDB v3. Klient napsaný pro TMDB čte z amodb po změně základní URL a klíče, pokud nevolá cestu z tabulky nenabízených níže. Volba tedy záleží na podmínkách, doplňcích a několika mezerách. TMDB nabízí bezplatné API pro kvalifikované užití podle vlastních podmínek. amodb je placené API jen pro čtení se 14 jazyky, pěti doplňkovými datovými bloky a limitem počítaným na klíč. ## Shoda endpointů Každý řádek ukazuje cestu pro čtení z TMDB v3 a jak se chová na `https://api.amodb.dev/3`. | Oblast | Cesta TMDB v3 | Na amodb | | -------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------- | | Detail filmu | `/movie/{movie_id}` | Totéž, s pěti dalšími hodnotami `append_to_response` | | Detail seriálu | `/tv/{series_id}` | Totéž, ale bez pole `type` a `created_by` je u většiny seriálů prázdné | | Sezóny a epizody | `/tv/{series_id}/season/{season_number}` | Stejný tvar. Obrázky, videa a překlady sezón jsou prázdné a `external_ids` sezón a epizod jsou null | | Osoby | `/person/{person_id}` | Totéž, s `combined_credits`, `movie_credits`, `tv_credits`, `external_ids` a `images` (jen profily) | | Obsazení a štáb | `/movie/{movie_id}/credits` | Totéž. U epizod je `cast` prázdné | | Hledání | `/search/multi` | Totéž, cache 10 minut | | Discover | `/discover/movie` | Totéž, cache 30 minut | | Trendy | `/trending/{media_type}/{time_window}` | Totéž, cache 30 minut | | Seznamy | `/movie/popular` | Totéž, `page` od 1 do 500 | | Obrázky | `/movie/{movie_id}/images` | Stejný tvar, soubory se načítají z `img.amodb.dev` | | Videa | `/movie/{movie_id}/videos` | Totéž | | Překlady | `/movie/{movie_id}/translations` | Totéž, podporuje se 14 jazyků | | Klíčová slova | `/movie/{movie_id}/keywords` | Totéž | | Recenze | `/movie/{movie_id}/reviews` | Odpovídá 200, ale recenze má jen několik titulů, prázdný seznam je proto normální | | Kolekce | `/collection/{collection_id}` | Totéž, `parts` řazeno podle data vydání | | Společnosti a sítě | `/company/{company_id}` | Stejné klíče. `description` společnosti je prázdné a `parent_company` je null | | Žánry | `/genre/movie/list` | Totéž | | Konfigurace | `/configuration` | Stejné klíče, hostitel obrázků je `img.amodb.dev` | | Hledání podle externího ID | `/find/{external_id}` | Stejný endpoint plus `kinopoisk_id`. `tv_episode_results` a `tv_season_results` jsou vždy prázdné | | Skupiny epizod | `/tv/{series_id}/episode_groups` | Vypíše skupiny seriálu bez jejich obsahu | ## Nenabízeno na amodb Tato volání TMDB v3 nemají ekvivalent. Neznámé cesty odpovídají 404 se `status_code` 34 a metody pro zápis odpovídají 405 se `status_code` 37. | Volání TMDB v3 | Odpověď amodb | | --------------------------------------------------------------------------------------------------------------- | --------------------- | | `/movie/changes`, `/tv/changes`, `/person/changes` a `changes` pod jedním ID | 404, `status_code` 34 | | `aggregate_credits` pod seriálem nebo sezónou | 404, `status_code` 34 | | `/credit/{credit_id}` a `/review/{review_id}` | 404, `status_code` 34 | | `/tv/episode_group/{id}` | 404, `status_code` 34 | | `/person/{person_id}/translations`, `tagged_images` a `/person/latest` | 404, `status_code` 34 | | `images`, `translations` a `alternative_names` pro kolekce, společnosti a sítě | 404, `status_code` 34 | | `/configuration/timezones` | 404, `status_code` 34 | | Vše pod `account`, `authentication`, `guest_session` a `list` a jakákoli cesta `/rating` nebo `/account_states` | 405, `status_code` 37 | Když do `append_to_response` přidáte `aggregate_credits` nebo `changes`, amodb název bez chyby ignoruje, takže klíč v těle jednoduše chybí. ## Srovnání funkcí | Funkce | TMDB | amodb | | ---------------- | --------------------------------------------------------------------- | ---------------------------------------------------------- | | Cenový model | Zdarma pro kvalifikované užití, podle podmínek TMDB | Předplatné, 1 až 24 měsíců na nákup | | Bezplatný tarif | Ano, pro kvalifikované užití | Žádný, ani zkušební verze | | Ověření | Klíč v3 v `api_key`, nebo token v4 jako Bearer | `api_key` nebo Bearer s 32znakovým hexadecimálním klíčem | | Formát odpovědi | JSON | JSON, stejná pole na cestách, které poskytuje | | Jazyky | Podívejte se do jejich dokumentace | 14 podporovaných, jiné tagy se vrátí k `en` | | Filmy | Ano | Ano | | Seriály | Ano | Ano | | Osoby | Ano | Ano | | Obrázky | Ano | `img.amodb.dev`, velikosti `w92` až `original` | | Hodnocení | Skóre uživatelů TMDB, jiné zdroje: podívejte se do jejich dokumentace | Pět zdrojů v jednom objektu, kde jsou známé | | Metody pro zápis | Metody účtu, seznamů a hodnocení | Žádné, odpovídají 405 | | Limit požadavků | Podívejte se do jejich dokumentace | 20, 40 nebo 120 za minutu na klíč | | Komerční užití | Ověřte si jejich podmínky komerčního užití a uvádění zdroje | Placené tarify, viz [ceník](https://amodb.dev/cs/pricing/) | | Kompatibilita | Definuje TMDB v3 | Většina cest pro čtení TMDB v3 a trasa OMDb | ## V čem se liší podrobněji - **Podmínky.** TMDB vás žádá, abyste si přečetli jeho podmínky komerčního užití a uvádění zdroje. amodb se prodává po předplacených obdobích, nemá automatické obnovení, bezplatný tarif ani zkušební verzi. - **Jazyky.** amodb podporuje en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it a es. Přijímá tagy TMDB jako `ru-RU` a `pt-BR`. Němčina, japonština a korejština se vrátí k `en`, zatímco `original_title` ponechává původní název. Pokrytí jazyků TMDB ověřte v jejich dokumentaci. Viz [jazyky](https://amodb.dev/cs/languages/). - **Rozšíření.** `append_to_response` přijímá také `moods`, `soundtracks`, `ratings`, `wikidata` a `showtimes` a každé z nich má vlastní cestu pod filmy a seriály. - **Externí ID.** `/3/find` převádí `imdb_id`, `tvdb_id`, `wikidata_id`, `kinopoisk_id`, `facebook_id`, `twitter_id` a `instagram_id`. Zdroje `freebase_mid`, `freebase_id`, `tvrage_id`, `tiktok_id` a `youtube_id` se přijímají, ale vracejí prázdná pole. Chybějící nebo neznámé `external_source` odpoví 400 se `status_code` 22. - **Prázdné záměrně.** Obrázky, videa a překlady sezón a `description` společnosti jsou vždy prázdné. Recenze a `created_by` u seriálu jsou vyplněny jen u několika titulů. `external_ids` sezón a epizod jsou všechna null. - **Tituly pro dospělé.** `include_adult` se ignoruje. Tituly a osoby pro dospělé se nikdy neposkytují a odpovídají 404. - **Obrázky.** Cesta CDN je `https://img.amodb.dev/t/p/{size}/{file}`. Klíč není potřeba a soubory se cachují 30 dní. - **Limity.** Okno je klouzavých 60 sekund na klíč. Hlavičky ukazují zbývající počet a zásahy cache se také počítají, protože kontrola limitu proběhne první. - **Nezávislost.** Katalog pochází z veřejných a otevřených zdrojů a z našeho vlastního obohacení. Sdílený tvar nezaručuje shodné hodnoty každého pole každého titulu. ## Kdy se TMDB hodí lépe - **Bezplatné kvalifikované užití.** Není třeba platit a amodb to nemůže vyrovnat. - **Zápisy.** Hodnocení titulu, vytváření seznamů a relace účtu fungují na TMDB. Na amodb vracejí 405. - **Feedy změn.** TMDB uvádí ID, která se změnila. amodb takový feed nemá, obnovujete tedy podle vlastního rozvrhu. - **Aggregate credits a vyhledání záznamů obsazení.** Obojí na amodb odpovídá 404. Použijte `/credits` u titulu. - **Širší jazykové potřeby.** Pokud vaše rozhraní potřebuje jazyk mimo 14, nejdřív si ověřte TMDB. - **Stávající schválení.** Tým, který TMDB prošel právním posouzením, by měl zvážit náklady druhého posouzení. ## Přechod na amodb Změna je jeden řádek na požadavek. ```bash # before: TMDB_BASE is your current TMDB v3 base URL curl -s "$TMDB_BASE/movie/550?api_key=$TMDB_KEY" # after curl -s "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY" ``` Před přepnutím porovnejte tvar několika odpovědí vedle sebe. Tento skript vypíše klíče nejvyšší úrovně, které jedna strana vrací a druhá ne. ```js async function topLevelKeys(base, key, path) { const res = await fetch(`${base}${path}?api_key=${key}`); if (!res.ok) throw new Error(`${path} returned ${res.status}`); return Object.keys(await res.json()).sort(); } for (const path of ['/movie/550', '/tv/1396', '/person/31']) { const current = await topLevelKeys(process.env.TMDB_BASE, process.env.TMDB_KEY, path); const next = await topLevelKeys('https://api.amodb.dev/3', process.env.AMODB_KEY, path); const missing = current.filter((k) => !next.includes(k)); console.log(path, missing.length ? `missing: ${missing.join(', ')}` : 'same keys'); } ``` Volitelná pole se u daného titulu mohou lišit, chybějící klíč proto berte jako stopu k prozkoumání, ne jako verdikt. Pak projděte tento seznam: 1. Vyberte tarif na stránce [ceník](https://amodb.dev/cs/pricing/) a vytvořte klíč v panelu účtu. 2. Přesuňte základní URL a klíč do konfigurace. 3. Přečtěte `images.secure_base_url` z `/3/configuration`. 4. Prohledejte kód kvůli voláním zápisu a cestám z tabulky nenabízených. Zápisy ponechte na TMDB a zbytek nahraďte. 5. Přidejte obsluhu 429, která počká `Retry-After` sekund. Viz [limity požadavků](https://amodb.dev/cs/rate-limits/) a [chyby](https://amodb.dev/cs/errors/). ## Ceník amodb je předplacené. Zvolte 1, 3, 6, 12 nebo 24 měsíců, u kterých je sleva 0, 10, 20, 30 nebo 40 procent, a jeden ze tří tarifů s 20, 40 nebo 120 požadavky za minutu. Každý tarif vrací všechna data a žádný se sám neobnovuje. Částky viz [ceník](https://amodb.dev/cs/pricing/). ## Otázky a odpovědi ### Jsou na amodb dostupné všechny endpointy pro čtení z TMDB v3? Ne. Většina cest pro čtení zachovává stejnou cestu, parametry dotazu a tvar JSON a tabulka shody na této stránce je řadí podle oblastí. Zápisy odpovídají 405 se status_code 37. Feedy změn, aggregate credits, vyhledání záznamů obsazení a recenzí, obsah skupin epizod a překlady osob odpovídají 404 se status_code 34. ### Co se v mém kódu změní při přechodu z TMDB? Tři věci: základní URL se změní na https://api.amodb.dev/3, klíč bude váš klíč amodb a URL obrázků používají img.amodb.dev. Základ obrázků čtěte z endpointu konfigurace. Cesty zůstávají stejné, kromě volání uvedených jako nenabízená. ### Zůstanou ID filmů a seriálů stejná? ID se řídí číslováním TMDB. Fight Club je 550 a Breaking Bad je 1396 v obou. Hodnoty jednotlivých polí se u některých titulů přesto mohou lišit, před přepnutím proto porovnejte vzorek z vlastního katalogu. ### Mohu používat obě služby společně? Ano. Protože je protokol stejný, můžete ponechat TMDB pro funkce účtu a seznamů, feedy změn a aggregate credits a amodb používat pro čtení katalogu. V konfiguraci držte dvě základní URL a dva klíče. ### Která služba je levnější? TMDB nabízí bezplatné API pro kvalifikované užití podle vlastních podmínek, takže když je splníte, nestojí nic. amodb je placené od prvního požadavku, s předplacenými obdobími 1 až 24 měsíců a slevou až 40 procent. ## Související stránky - [Alternativa k API TMDB](https://amodb.dev/cs/tmdb-api-alternative/): Hledáte alternativu k API TMDB? Ověřte podmínky, limity, jazyky a hodnocení a přejděte na placené API, které zachovává většinu cest pro čtení TMDB v3 a JSON. - [API databáze filmů pro váš vlastní katalog](https://amodb.dev/cs/movie-database-api/): API databáze filmů pro vlastní lokální kopii: filmy, osoby, společnosti, kolekce a klíčová slova s propojenými ID, okna dat v discover a vyhledání podle ID. - [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. - [Autentizace](https://amodb.dev/cs/authentication/): Jak poslat klíč amodb: api_key v dotazu, hlavička Authorization Bearer nebo apikey pro volání OMDb. Formát klíče, uložení, rotace a chyby 401. - [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. - [Ceník](https://amodb.dev/cs/pricing/): Tarify amodb se liší jen počtem požadavků za minutu: 20, 40 nebo 120. Každý zahrnuje všechna data kompatibilní s TMDB v3 a OMDb. Bez obnovení a zkušební verze. Aktualizováno: 2026-10-18. Source: https://amodb.dev/cs/amodb-vs-tmdb/