# Alternativa k API Kinopoisk > Kinopoisk je ruskojazyčný filmový web a nezveřejňuje obecné otevřené API. Vývojáři často sahají po službách třetích stran, ověřte si proto jejich dokumentaci. amodb je placené API, které vrací ruské názvy přes language=ru-RU, najde titul podle ID z Kinopoisku a zahrnuje skóre Kinopoisku, kde je známé. ## Co alternativa dokáže a co ne Kinopoisk je ruskojazyčný filmový web a nezveřejňuje obecné otevřené API. Vývojáři často místo toho používají služby třetích stran, každou s vlastními podmínkami, podívejte se proto do jejich dokumentace. amodb je nezávislé API, ne služba Kinopoisku. Pokrývá tři potřeby, které ruskojazyčné projekty často mají: názvy a popisy rusky, vyhledání podle ID z Kinopoisku a skóre Kinopoisku vedle dalších skóre tam, kde je známé. ## Stavební kameny | Co potřebujete | Jak | Co se vrátí | | ------------------------------ | ---------------------------------------------- | ------------------------------------------------- | | Ruský název a popis | `language=ru-RU` v libovolném volání detailů | `title` rusky, `original_title` beze změny | | Titul z ID z Kinopoisku | `GET /3/find/361?external_source=kinopoisk_id` | `movie_results` s ID 550 | | ID z Kinopoisku titulu | `GET /3/movie/550/external_ids` | `kinopoisk_id` jako řetězec, zde `"361"` | | Skóre Kinopoisku | `GET /3/movie/550/ratings` | `kinopoisk` s `value` a `votes`, nebo null | | Ukrajinský nebo běloruský text | `language=uk-UA` nebo `language=be-BY` | Lokalizovaná pole, anglicky tam, kde žádná nejsou | Další blok ukazuje jednu odpověď detailu rusky s `append_to_response=ratings`. Je to skutečná odpověď pro Fight Club (ID 550), zkrácená na zde použitá pole a s krátkým popisem. ```json { "id": 550, "original_title": "Fight Club", "overview": "Сотрудник страховой компании страдает хронической бессонницей и отчаянно пытается вырваться из му...", "release_date": "1999-10-15", "tagline": "«Интриги. Хаос. Мыло»", "title": "Бойцовский клуб", "ratings": { "imdb": { "value": 8.8, "votes": 2669989 }, "kinopoisk": { "value": 8.7, "votes": null }, "metacritic": { "value": 67, "votes": null }, "rotten_tomatoes": { "value": 81, "votes": null }, "tmdb": { "value": 8.437, "votes": 33039 } } } ``` Objekt ratings vždy uvádí stejných pět klíčů. Skóre Kinopoisku je zde 8.7 a jeho `votes` je `null`, počet hlasů Kinopoisku proto nelze brát jako samozřejmost. Podrobnosti jsou na stránce [hodnocení](https://amodb.dev/cs/ratings/). ## Srovnání funkcí | Funkce | Kinopoisk | amodb | | --------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------- | | Cenový model | Žádné obecné otevřené API, u služeb třetích stran se podívejte do jejich dokumentace | Předplatné, 1 až 24 měsíců na nákup | | Bezplatný tarif | Podívejte se do jejich dokumentace | Žádný, ani zkušební verze | | Ověření | Podívejte se do jejich dokumentace | `api_key` nebo hlavička Bearer | | Formát odpovědi | Podívejte se do jejich dokumentace | JSON ve tvaru TMDB v3 | | Jazyky | Ruskojazyčný web | 14 jazyků rozhraní, mezi nimi ruština | | Filmy | Na webu | Detaily, obsazení, obrázky, videa | | Seriály | Na webu | Seriály, sezóny a epizody | | Osoby | Na webu | Profily a filmografie | | Obrázky | Na webu | `img.amodb.dev`, klíč není potřeba | | Hodnocení | Vlastní skóre publika na webu | Skóre Kinopoisku plus č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í | Podívejte se do jejich dokumentace | Placené tarify, viz [ceník](https://amodb.dev/cs/pricing/) | | Kompatibilita | Žádné obecné otevřené API, podívejte se do jejich dokumentace | Čtení TMDB v3 a OMDb | ## V čem se amodb liší - **Zdokumentovaná smlouva.** Cesty, parametry, těla chyb a limity jsou sepsané a jeden klíč obsluhuje každý endpoint. - **Ruština vedle jiných jazyků.** Stejné volání s jinou hodnotou `language` dá stejná pole v jiném jazyce. To pomáhá, když vaše publikum čte rusky, ukrajinsky a anglicky. - **Několik skóre v jednom objektu.** Skóre Kinopoisku můžete zobrazit vedle IMDb, Metacritic a Rotten Tomatoes, každé `null`, když je neznámé. - **Zachované původní názvy.** `original_title` a `original_name` drží titul v původním jazyce, včetně japonštiny a korejštiny, i když to nejsou jazyky rozhraní. ## Kdy se Kinopoisk hodí lépe - **Komunita samotná.** Recenze, seznamy, uživatelské stránky a místní diskuse žijí na webu. amodb nic z toho nenabízí, jen skóre, kde je známé. - **Vše mimo metadata.** Pro obsah, který není polem metadat, použijte web samotný. API s metadaty ho nenese. - **Vlastní skóre publika.** Hodnota vzniká nejdřív tam. V amodb může být `null` u nového nebo málo známého titulu a počet hlasů může být `null`, i když je skóre nastaveno. ## Přechod na amodb Shromážděte ID z Kinopoisku, která ukládáte, jednou je namapujte přes `/3/find` a číselné ID amodb držte vedle nich. Poté si vyžádejte detaily rusky a skóre čtěte ze stejné odpovědi. ```python import os import requests KEY = os.environ["AMODB_KEY"] BASE = "https://api.amodb.dev/3" HEADERS = {"Authorization": f"Bearer {KEY}"} def get(path, **params): r = requests.get(BASE + path, params=params, headers=HEADERS, timeout=10) r.raise_for_status() return r.json() found = get("/find/361", external_source="kinopoisk_id") movie_id = found["movie_results"][0]["id"] movie = get(f"/movie/{movie_id}", language="ru-RU", append_to_response="ratings") kp = movie["ratings"]["kinopoisk"] print(movie["title"], "/", movie["original_title"]) print("Kinopoisk:", kp["value"] if kp else "not known") ``` Prázdné pole `movie_results` znamená, že pro dané ID není shoda. ID seriálu z Kinopoisku naplní místo toho `tv_results`, čtěte proto obě pole, když druh neznáte. U 429 počkejte `Retry-After` sekund. Seznam jazyků je na stránce [jazyky](https://amodb.dev/cs/languages/) a pravidla vyhledání na stránce [hledání podle externího ID](https://amodb.dev/cs/find-by-external-id/). ## Ošetření mezer v ruském textu Textové pole může být prázdné, když pro titul neexistuje ruský překlad. Zkontrolujte prázdný řetězec a tento jeden titul vyžádejte znovu s `language=en-US`. Pro plakáty s ruským písmem zavolejte `/3/movie/550/images?include_image_language=ru,null` a vybírejte z `posters`. Hodnota `null` ponechá v seznamu grafiku bez textu. Velikosti viz [obrázky](https://amodb.dev/cs/images-api/). ## Ceník amodb nemá bezplatný tarif. Předplácíte 1, 3, 6, 12 nebo 24 měsíců u jednoho ze tří tarifů a delší období stojí o 10, 20, 30 nebo 40 procent méně. Tarify povolují 20, 40 nebo 120 požadavků za minutu, vracejí stejná data a samy se neobnovují. Částky jsou na stránce [ceník](https://amodb.dev/cs/pricing/). ## Otázky a odpovědi ### Má Kinopoisk oficiální veřejné API? Kinopoisk je ruskojazyčný filmový web a nezveřejňuje obecné otevřené API. Vývojáři často používají služby třetích stran, každou s vlastními podmínkami. Než na některou spolehnete, podívejte se do jejich dokumentace. ### Jak na amodb najdu titul podle ID z Kinopoisku? Zavolejte /3/find s ID z Kinopoisku a external_source=kinopoisk_id. Například 361 vede na Fight Club, tedy ID 550, a 404900 na Breaking Bad, ID 1396. Výsledek přijde v movie_results nebo tv_results ve tvaru TMDB. ### Vrací se hodnocení Kinopoisku vždy? Ne. Klíč kinopoisk v objektu ratings obsahuje value a votes, kde je skóre známo, jinak null. Hodnota je z 10 na jedno desetinné místo. votes může být null i při nastavené value, zobrazte ho proto jen tehdy, když je přítomné. ### Které jazyky mohu kromě ruštiny vyžádat? Celkem čtrnáct, včetně ukrajinštiny a běloruštiny. V parametru language pošlete tag TMDB, například uk-UA nebo be-BY. Nepodporované tagy se vrátí k angličtině a původní názvy zůstávají v original_title. ### Dostanu text recenzí z Kinopoisku? Ne. amodb vrací skóre Kinopoisku, kde je známé. Text recenzí, seznamy a komunitní funkce webu nejsou součástí API a endpoint recenzí ve stylu TMDB vrací u většiny titulů prázdný seznam. ## Související stránky - [API vícejazyčných metadat filmů](https://amodb.dev/cs/multilingual-movie-metadata-api/): API vícejazyčných metadat filmů ve 14 jazycích: tagy TMDB, všechny překlady, návrat k angličtině a podpora hebrejštiny zprava doleva. Jeden klíč. - [Hodnocení filmů a seriálů](https://amodb.dev/cs/ratings/): API hodnocení filmů, které vrací skóre z IMDb, Kinopoisk, Metacritic, Rotten Tomatoes a TMDB pro titul jedním voláním, s null u každého neznámého zdroje. - [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. - [Jazyky](https://amodb.dev/cs/languages/): amodb vrací názvy, popisy a jména ve 14 jazycích. Do language předejte tag ve stylu TMDB, např. ru-RU nebo pt-BR; jakýkoli jiný tag použije angličtinu. - [Alternativa k API IMDb](https://amodb.dev/cs/imdb-api-alternative/): IMDb nemá bezplatné univerzální REST API. Hledejte tituly podle ID z IMDb, čtěte hodnocení IMDb a získejte obsazení a trailery z placeného JSON API. - [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/kinopoisk-api-alternative/