# Алтернатива на Kinopoisk API > Kinopoisk е рускоезичен сайт за кино и няма общо отворено API. Разработчиците често се обръщат към външни услуги, затова вижте документацията им. amodb е платено API, което връща руски заглавия с language=ru-RU, намира заглавие по Kinopoisk id и включва оценката на Kinopoisk, където е известна. ## Какво може и какво не може да ви даде една алтернатива Kinopoisk е рускоезичен сайт за кино и няма общо отворено API. Разработчиците често ползват вместо това външни услуги, всяка със свои условия, затова вижте документацията им. amodb е независимо API, а не услуга на Kinopoisk. Покрива три нужди, които рускоезичните проекти често имат: заглавия и описания на руски, търсене по Kinopoisk id и оценката на Kinopoisk до другите оценки, където е известна. ## Градивни елементи | От какво имате нужда | Как | Какво се връща | | -------------------------------- | ----------------------------------------------- | ----------------------------------------------- | | Руско заглавие и описание | `language=ru-RU` при всяко извикване за детайли | `title` на руски, `original_title` без промяна | | Заглавие по Kinopoisk id | `GET /3/find/361?external_source=kinopoisk_id` | `movie_results` с id 550 | | Kinopoisk id на заглавие | `GET /3/movie/550/external_ids` | `kinopoisk_id` като низ, тук `"361"` | | Оценката на Kinopoisk | `GET /3/movie/550/ratings` | `kinopoisk` с `value` и `votes`, или null | | Текст на украински или беларуски | `language=uk-UA` или `language=be-BY` | Локализирани полета, английски там, където няма | Следващият блок показва един отговор за детайли на руски с `append_to_response=ratings`. Това е истински отговор за Fight Club (id 550), съкратен до използваните тук полета и със съкратено описание. ```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 } } } ``` Обектът ratings винаги изброява същите пет ключа. Тук оценката на Kinopoisk е 8.7, а нейното `votes` е `null`, така че броят гласове на Kinopoisk не може да се приема за даденост. Подробности има на страницата [рейтинги](https://amodb.dev/bg/ratings/). ## Сравнение на функциите | Функция | Kinopoisk | amodb | | ------------------ | ---------------------------------------------------------------- | ------------------------------------------------------------------- | | Модел на цените | Няма общо отворено API, за външни услуги вижте документацията им | Предплатен, от 1 до 24 месеца на покупка | | Безплатен план | Вижте документацията им | Няма, и няма пробен период | | Удостоверяване | Вижте документацията им | `api_key` или заглавка Bearer | | Формат на отговора | Вижте документацията им | JSON във формата на TMDB v3 | | Езици | Рускоезичен сайт | 14 езика на интерфейса, сред тях руски | | Филми | На сайта | Детайли, участници, изображения, видеа | | Сериали | На сайта | Сериали, сезони и епизоди | | Личности | На сайта | Профили и филмография | | Изображения | На сайта | `img.amodb.dev`, не е нужен ключ | | Рейтинги | Собствена оценка на зрителите на сайта | Оценката на Kinopoisk плюс още четири източника, където са известни | | Лимит на заявките | Вижте документацията им | 20, 40 или 120 в минута на ключ | | Търговска употреба | Вижте документацията им | Платени планове, вижте [цени](https://amodb.dev/bg/pricing/) | | Съвместимост | Няма общо отворено API, вижте документацията им | Четене по TMDB v3 и OMDb | ## С какво се различава amodb - **Документиран договор.** Пътищата, параметрите, телата на грешките и лимитите са описани, а един ключ обслужва всеки ендпойнт. - **Руски до други езици.** Същото извикване с друга стойност на `language` дава същите полета на друг език. Това помага, когато аудиторията ви чете руски, украински и английски. - **Няколко оценки в един обект.** Можете да покажете оценката на Kinopoisk до IMDb, Metacritic и Rotten Tomatoes, всяка `null`, когато е неизвестна. - **Оригиналните заглавия се пазят.** `original_title` и `original_name` държат заглавието на езика на източника, включително японски и корейски, макар да не са езици на интерфейса. ## Къде Kinopoisk пасва по-добре - **Самата общност.** Ревюта, списъци, потребителски страници и местни дискусии живеят на сайта. amodb не предлага нищо от това, само оценката, където е известна. - **Всичко отвъд метаданните.** За съдържание, което не е поле с метаданни, ползвайте самия сайт. API за метаданни не го носи. - **Собствената оценка на зрителите.** Стойността се произвежда първо там. В amodb тя може да е `null` за ново или малко познато заглавие, а броят гласове може да е `null`, дори когато оценката е зададена. ## Миграция към amodb Съберете Kinopoisk id, които пазите, съпоставете ги веднъж през `/3/find` и пазете числовото id от amodb до тях. После искайте детайли на руски и четете оценката от същия отговор. ```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") ``` Празен масив `movie_results` означава, че няма съвпадение за това id. Kinopoisk id на сериал попълва вместо това `tv_results`, така че четете и двата масива, когато не знаете вида. При 429 изчакайте `Retry-After` секунди. Списъкът с езици е на страницата [езици](https://amodb.dev/bg/languages/), а правилата за търсене са на страницата [търсене по външен идентификатор](https://amodb.dev/bg/find-by-external-id/). ## Как да се справите с пропуски в руския текст Текстово поле може да е празно, когато за заглавието няма превод на руски. Проверете за празен низ и поискайте това заглавие отново с `language=en-US`. За постери с руски надписи извикайте `/3/movie/550/images?include_image_language=ru,null` и изберете от `posters`. Стойността `null` оставя в списъка изображения без текст. Вижте [изображения](https://amodb.dev/bg/images-api/) за размерите. ## Цени amodb няма безплатен план. Плащате предварително за 1, 3, 6, 12 или 24 месеца по един от три плана, а по-дълъг период струва 10, 20, 30 или 40 процента по-малко. Плановете позволяват 20, 40 или 120 заявки в минута, връщат едни и същи данни и не се подновяват автоматично. Сумите са на страницата с [цените](https://amodb.dev/bg/pricing/). ## Въпроси и отговори ### Има ли Kinopoisk официално публично API? Kinopoisk е рускоезичен сайт за кино и няма общо отворено API. Разработчиците често ползват външни услуги, всяка със свои условия. Вижте документацията им, преди да разчитате на някоя. ### Как да намеря заглавие по Kinopoisk id в amodb? Извикайте /3/find с Kinopoisk id и external_source=kinopoisk_id. Например 361 води до Fight Club, което е id 550, а 404900 води до Breaking Bad, id 1396. Резултатът идва в movie_results или tv_results във формата на TMDB. ### Връща ли се винаги рейтингът на Kinopoisk? Не. Ключът kinopoisk в обекта ratings съдържа value и votes, където оценката е известна, и null в останалите случаи. Стойността е от 10 с един десетичен знак. votes може да е null дори когато value е зададено, затова го показвайте само когато го има. ### Кои езици мога да поискам освен руския? Общо четиринайсет, включително украински и беларуски. Подайте таг на TMDB като uk-UA или be-BY в параметъра language. Неподдържаните тагове се заменят с английски, а оригиналните заглавия остават в original_title. ### Получавам ли текста на ревюта от Kinopoisk? Не. amodb връща оценката на Kinopoisk, където е известна. Текстът на ревютата, списъците и общностните функции на сайта не са част от API, а ендпойнтът за ревюта в стил TMDB връща празен списък за повечето заглавия. ## Свързани страници - [Многоезично API за метаданни на филми](https://amodb.dev/bg/multilingual-movie-metadata-api/): Многоезично API за метаданни на филми на 14 езика. Тагове за език на TMDB, всички преводи, резервен английски и правилно показване на иврит отдясно наляво. - [Рейтинги на филми и сериали](https://amodb.dev/bg/ratings/): API за рейтинги на филми връща оценки от IMDb, Kinopoisk, Metacritic, Rotten Tomatoes и TMDB за заглавие с едно извикване, с null за неизвестен източник. - [Търсене по външен идентификатор](https://amodb.dev/bg/find-by-external-id/): Търсете филм, сериал или личност по IMDb, TVDB, Wikidata или Kinopoisk id с ендпойнта find на TMDB и четете външни id и факти от Wikidata за заглавие. - [Езици](https://amodb.dev/bg/languages/): amodb връща заглавия, описания и имена на 14 езика. Подайте таг в стил TMDB, например ru-RU или pt-BR, в language; всеки друг таг се заменя с английски. - [Алтернатива на IMDb API](https://amodb.dev/bg/imdb-api-alternative/): IMDb няма безплатно REST API. Търсете заглавия по IMDb id, четете рейтинга на IMDb и вземайте актьори, изображения и трейлъри от платено API. - [Цени](https://amodb.dev/bg/pricing/): Планове на amodb, различни само по заявките в минута: 20, 40 или 120. Всеки включва всички данни, съвместими с TMDB v3 и OMDb. Предплатено, без подновяване. Обновено: 2026-10-18. Source: https://amodb.dev/bg/kinopoisk-api-alternative/