# Alternatywa dla API Kinopoisk

> Kinopoisk to rosyjskojęzyczny serwis filmowy i nie publikuje ogólnego otwartego API. Programiści często sięgają po usługi stron trzecich, więc sprawdź ich dokumentację. amodb to płatne API, które zwraca rosyjskie tytuły przez language=ru-RU, znajduje tytuł po ID z Kinopoisk i zawiera wynik Kinopoisk, gdy jest znany.

## Co może dać alternatywa, a czego nie

Kinopoisk to rosyjskojęzyczny serwis filmowy i nie publikuje ogólnego otwartego API. Programiści często używają zamiast tego usług stron trzecich, każdej z własnymi warunkami, więc sprawdź ich dokumentację. amodb to niezależne API, a nie usługa Kinopoisk. Pokrywa trzy potrzeby, które często mają projekty rosyjskojęzyczne: tytuły i opisy po rosyjsku, wyszukiwanie po ID z Kinopoisk oraz wynik Kinopoisk obok innych wyników tam, gdzie jest znany.

## Elementy składowe

| Czego potrzebujesz             | Jak                                              | Co wraca                                                   |
| ------------------------------ | ------------------------------------------------ | ---------------------------------------------------------- |
| Rosyjski tytuł i opis          | `language=ru-RU` w dowolnym wywołaniu szczegółów | `title` po rosyjsku, `original_title` bez zmian            |
| Tytuł z ID z Kinopoisk         | `GET /3/find/361?external_source=kinopoisk_id`   | `movie_results` z ID 550                                   |
| ID z Kinopoisk tytułu          | `GET /3/movie/550/external_ids`                  | `kinopoisk_id` jako ciąg, tu `"361"`                       |
| Wynik Kinopoisk                | `GET /3/movie/550/ratings`                       | `kinopoisk` z `value` i `votes` albo null                  |
| Tekst ukraiński lub białoruski | `language=uk-UA` lub `language=be-BY`            | Zlokalizowane pola, po angielsku tam, gdzie żadnych nie ma |

Następny blok pokazuje jedną odpowiedź szczegółów po rosyjsku z `append_to_response=ratings`. To prawdziwa odpowiedź dla Fight Club (ID 550), przycięta do użytych tu pól i ze skróconym opisem.

```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
    }
  }
}
```

Obiekt ratings zawsze wymienia te same pięć kluczy. Wynik Kinopoisk to tu 8.7, a jego `votes` ma wartość `null`, więc liczby głosów Kinopoisk nie można brać za pewnik. Szczegóły są na stronie [oceny](https://amodb.dev/pl/ratings/).

## Porównanie funkcji

| Funkcja           | Kinopoisk                                                                      | amodb                                                        |
| ----------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------ |
| Model cenowy      | Brak ogólnego otwartego API, dla usług stron trzecich sprawdź ich dokumentację | Przedpłata, od 1 do 24 miesięcy na zakup                     |
| Darmowy plan      | Sprawdź ich dokumentację                                                       | Brak, ani wersji próbnej                                     |
| Uwierzytelnianie  | Sprawdź ich dokumentację                                                       | `api_key` lub nagłówek Bearer                                |
| Format odpowiedzi | Sprawdź ich dokumentację                                                       | JSON w kształcie TMDB v3                                     |
| Języki            | Rosyjskojęzyczny serwis                                                        | 14 języków interfejsu, w tym rosyjski                        |
| Filmy             | W serwisie                                                                     | Szczegóły, obsada, obrazy, wideo                             |
| Seriale           | W serwisie                                                                     | Seriale, sezony i odcinki                                    |
| Osoby             | W serwisie                                                                     | Profile i filmografia                                        |
| Obrazy            | W serwisie                                                                     | `img.amodb.dev`, klucz niepotrzebny                          |
| Oceny             | Własny wynik publiczności w serwisie                                           | Wynik Kinopoisk plus cztery inne źródła, gdy znane           |
| Limit żądań       | Sprawdź ich dokumentację                                                       | 20, 40 lub 120 na minutę na klucz                            |
| Użycie komercyjne | Sprawdź ich dokumentację                                                       | Płatne plany, zobacz [cennik](https://amodb.dev/pl/pricing/) |
| Zgodność          | Brak ogólnego otwartego API, sprawdź ich dokumentację                          | Odczyty TMDB v3 i OMDb                                       |

## Czym amodb się różni

- **Udokumentowany kontrakt.** Ścieżki, parametry, treści błędów i limity są spisane, a jeden klucz obsługuje każdy endpoint.
- **Rosyjski obok innych języków.** To samo wywołanie z inną wartością `language` daje te same pola w innym języku. To pomaga, gdy twoi odbiorcy czytają po rosyjsku, ukraińsku i angielsku.
- **Kilka wyników w jednym obiekcie.** Wynik Kinopoisk możesz pokazać obok IMDb, Metacritic i Rotten Tomatoes, każdy z `null`, gdy nieznany.
- **Zachowane tytuły oryginalne.** `original_title` i `original_name` trzymają tytuł w języku źródłowym, w tym po japońsku i koreańsku, choć to nie są języki interfejsu.

## Kiedy Kinopoisk pasuje lepiej

- **Sama społeczność.** Recenzje, listy, strony użytkowników i lokalne dyskusje żyją w serwisie. amodb nie oferuje niczego z tego, tylko wynik, gdy znany.
- **Wszystko poza metadanymi.** Dla treści, która nie jest polem metadanych, użyj samego serwisu. API metadanych jej nie niesie.
- **Własny wynik publiczności.** Wartość powstaje najpierw tam. W amodb może mieć wartość `null` dla nowego lub mało znanego tytułu, a liczba głosów może mieć wartość `null`, nawet gdy wynik jest ustawiony.

## Przejście na amodb

Zbierz ID z Kinopoisk, które przechowujesz, zmapuj je raz przez `/3/find` i trzymaj obok nich numeryczne ID amodb. Potem żądaj szczegółów po rosyjsku i odczytuj wynik z tej samej odpowiedzi.

```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")
```

Pusta tablica `movie_results` oznacza brak dopasowania dla tego ID. ID serialu z Kinopoisk wypełnia zamiast tego `tv_results`, więc czytaj obie tablice, gdy nie znasz rodzaju. Przy 429 poczekaj `Retry-After` sekund. Lista języków jest na stronie [języki](https://amodb.dev/pl/languages/), a zasady wyszukiwania na stronie [wyszukiwanie po zewnętrznym ID](https://amodb.dev/pl/find-by-external-id/).

## Obsługa luk w tekście rosyjskim

Pole tekstowe może być puste, gdy dla tytułu nie istnieje rosyjskie tłumaczenie. Sprawdź pusty ciąg i zażądaj tego jednego tytułu ponownie z `language=en-US`. Dla plakatów z rosyjskim napisem wywołaj `/3/movie/550/images?include_image_language=ru,null` i wybieraj z `posters`. Wartość `null` zostawia na liście grafiki bez tekstu. Rozmiary zobacz w [obrazy](https://amodb.dev/pl/images-api/).

## Cennik

amodb nie ma darmowego planu. Przedpłacasz 1, 3, 6, 12 lub 24 miesiące na jednym z trzech planów, a dłuższy okres kosztuje o 10, 20, 30 lub 40 procent mniej. Plany dopuszczają 20, 40 lub 120 żądań na minutę, zwracają te same dane i nie odnawiają się automatycznie. Kwoty są na stronie [cennik](https://amodb.dev/pl/pricing/).

## Pytania i odpowiedzi

### Czy Kinopoisk ma oficjalne publiczne API?

Kinopoisk to rosyjskojęzyczny serwis filmowy i nie publikuje ogólnego otwartego API. Programiści często używają usług stron trzecich, każdej z własnymi warunkami. Zanim na którejś polegasz, sprawdź jej dokumentację.

### Jak znaleźć tytuł po ID z Kinopoisk w amodb?

Wywołaj /3/find z ID z Kinopoisk i external_source=kinopoisk_id. Na przykład 361 prowadzi do Fight Club, czyli ID 550, a 404900 do Breaking Bad, ID 1396. Wynik przychodzi w movie_results lub tv_results w kształcie TMDB.

### Czy ocena Kinopoisk jest zawsze zwracana?

Nie. Klucz kinopoisk w obiekcie ratings zawiera value i votes, gdy wynik jest znany, a w przeciwnym razie null. Wartość jest w skali do 10 z jednym miejscem po przecinku. votes może mieć wartość null nawet przy ustawionym value, więc pokaż go tylko wtedy, gdy jest obecny.

### Jakie języki mogę zażądać poza rosyjskim?

Łącznie czternaście, w tym ukraiński i białoruski. Przekaż tag TMDB, na przykład uk-UA lub be-BY, w parametrze language. Nieobsługiwane tagi wracają do angielskiego, a tytuły oryginalne zostają w original_title.

### Czy dostanę tekst recenzji z Kinopoisk?

Nie. amodb zwraca wynik Kinopoisk, gdy jest znany. Tekst recenzji, listy i funkcje społecznościowe serwisu nie są częścią API, a endpoint recenzji w stylu TMDB zwraca pustą listę dla większości tytułów.

## Powiązane strony

- [API wielojęzycznych metadanych filmów](https://amodb.dev/pl/multilingual-movie-metadata-api/): API wielojęzycznych metadanych filmów w 14 językach: tagi TMDB, wszystkie tłumaczenia, powrót do angielskiego i obsługa hebrajskiego od prawej do lewej.
- [Oceny filmów i seriali](https://amodb.dev/pl/ratings/): API ocen filmów zwraca wyniki z IMDb, Kinopoisk, Metacritic, Rotten Tomatoes i TMDB dla tytułu jednym wywołaniem, z null dla każdego nieznanego źródła.
- [Wyszukiwanie po zewnętrznym ID](https://amodb.dev/pl/find-by-external-id/): Znajdź film, serial lub osobę po ID z IMDb, TVDB, Wikidata lub Kinopoisk przez endpoint find z TMDB oraz odczytaj zewnętrzne ID i fakty z Wikidata o tytule.
- [Języki](https://amodb.dev/pl/languages/): amodb serwuje tytuły, opisy i nazwy w 14 językach. Podaj tag w stylu TMDB, np. ru-RU lub pt-BR, w language; każdy inny tag wraca do angielskiego.
- [Alternatywa dla API IMDb](https://amodb.dev/pl/imdb-api-alternative/): IMDb nie ma darmowego uniwersalnego REST API. Wyszukuj tytuły po ID z IMDb, czytaj ocenę IMDb oraz pobieraj obsadę i zwiastuny z płatnego API JSON.
- [Cennik](https://amodb.dev/pl/pricing/): Plany amodb płatne z góry różnią się tylko limitem żądań na minutę: 20, 40 lub 120. Każdy plan ma wszystkie dane TMDB v3 i OMDb. Bez odnowień i okresu próbnego.

Zaktualizowano: 2026-10-18. Source: https://amodb.dev/pl/kinopoisk-api-alternative/