Use cases
These pages show how amodb fits common products: catalogs, media servers, recommendation tools, chat bots and research. Each page lists the endpoints you need, the request rate that fits, and the plan that covers it. Every plan includes all data; plans differ only in requests per minute.
-
Filmové API pro vyhledávání, detaily a hodnocení
amodb je placené filmové API na https://api.amodb.dev/3 se stejnými cestami a JSON jako TMDB v3. Titul vyhledáte přes /search/movie, pak film načtete s append_to_response a získáte obsazení, trailery a hodnocení v jednom požadavku. Odpovědi přicházejí ve 14 jazycích, od 20 požadavků za minutu.
-
API seriálů pro seriály, sezóny a epizody
API seriálů vrací seriál na GET /3/tv/{series_id} se stavem, televizními sítěmi, seznamem sezón a next_episode_to_air. Endpointy sezón a epizod doplňují data vysílání, délky a záběry. JSON odpovídá TMDB v3, ve 14 jazycích, v předplacených tarifech s 20, 40 nebo 120 požadavky za minutu.
-
amodb nemá samostatný endpoint pro anime. Anime vypíšete přes /3/discover/tv nebo /3/discover/movie se žánrem 16 a with_original_language=ja a pak seznam zúžíte pomocí ID klíčového slova anime z /3/search/keyword. Japonština sice není podporovaný jazyk rozhraní, ale original_name uchovává původní japonský název titulu.
-
API databáze filmů pro váš vlastní katalog
Používejte amodb jako zdroj pro vlastní databázi filmů. Filmy, osoby, společnosti, kolekce, klíčová slova a žánry sdílejí číselná ID, takže se řádky čistě spojují. První data načtěte stránkováním discover v oknech dat premiér, řádky obnovujte podle stáří a vlastní ID přiřaďte přes hledání podle externího ID. JSON TMDB v3, 20 až 120 požadavků za minutu.
-
API plakátů filmů a CDN obrázků
Plakáty se načítají z https://img.amodb.dev/t/p/{size}/{file} bez klíče API. Část file je poster_path z libovolné odpovědi s filmem, vyhledáváním nebo seznamem. Názvy velikostí jdou od w92 po original a include_image_language vybírá plakáty podle jazyka. Klíč potřebují jen volání JSON, která vracejí názvy souborů.
-
API trailerů filmů je GET /3/movie/{movie_id}/videos na api.amodb.dev. Každé video nese typ, příznak official, jazyk a datum zveřejnění, takže oficiální trailer vyberete jedním průchodem. Seriály vracejí stejný tvar a seznam si seřadíte vlastním kódem. Cesty a JSON odpovídají TMDB v3, takže stávající klienti fungují po změně základní URL.
-
API pro herce je rodina endpointů osob v TMDB v3 na api.amodb.dev/3. Osobu načtete přes GET /3/person/{person_id}, přidáním combined_credits získáte celou filmografii a přidáním images profilové fotografie. Seznam populárních osob, hledání podle jména i vyhledání podle IMDb ID používají stejný klíč a stejný tvar JSON.
-
API vícejazyčných metadat filmů
Toto API vícejazyčných metadat filmů vrací názvy, popisy, slogany, názvy žánrů a biografie ve 14 jazycích: angličtina, ruština, ukrajinština, běloruština, čínština, portugalština, bulharština, hebrejština, čeština, rumunština, francouzština, polština, italština a španělština. Stačí předat jeden tag TMDB, například ru-RU, v parametru language.
-
API promítacích časů kin je GET /3/movie/{movie_id}/showtimes?country=US. Vrací kina s adresou a časovým pásmem a u každého promítání čas začátku, formáty a odkaz na rezervaci, pokud jsou známé. Bez country dostanete jen počty podle zemí. Pokrytí se liší podle titulu a prázdné pole results znamená, že nic není známo.
-
API průvodce epizodami vypíše všechny epizody seriálu přes GET /3/tv/{tv_id}/season/{season_number}. Každá epizoda má název, popis, datum vysílání, délku a záběr. Seznam episode_groups pojmenovává alternativní řazení, například DVD nebo absolutní. Cesty a JSON odpovídají TMDB v3, takže stávající klienti potřebují jen novou základní URL.
Start with one key
Every plan includes all endpoints, all 14 languages and images. Plans differ only in requests per minute.