# Alternativa all'API Kinopoisk > Kinopoisk è un sito di cinema in lingua russa e non pubblica un'API aperta generica. Gli sviluppatori si rivolgono spesso a servizi di terze parti, quindi controlla la loro documentazione. amodb è un'API a pagamento che restituisce i titoli in russo con language=ru-RU, trova un titolo tramite l'ID Kinopoisk e include il punteggio Kinopoisk quando è noto. ## Cosa può e cosa non può darti un'alternativa Kinopoisk è un sito di cinema in lingua russa e non pubblica un'API aperta generica. Gli sviluppatori usano spesso servizi di terze parti, ciascuno con le proprie condizioni, quindi controlla la loro documentazione. amodb è un'API indipendente e non un servizio Kinopoisk. Copre tre esigenze frequenti nei progetti in lingua russa: titoli e trame in russo, ricerca per ID Kinopoisk e punteggio Kinopoisk accanto agli altri punteggi, quando è noto. ## I blocchi di base | Ti serve | Come | Cosa ottieni | | ----------------------------- | --------------------------------------------------- | ------------------------------------------------------ | | Titolo e trama in russo | `language=ru-RU` su qualsiasi chiamata di dettaglio | `title` in russo, `original_title` invariato | | Un titolo da un ID Kinopoisk | `GET /3/find/361?external_source=kinopoisk_id` | `movie_results` con id 550 | | L'ID Kinopoisk di un titolo | `GET /3/movie/550/external_ids` | `kinopoisk_id` come stringa, qui `"361"` | | Il punteggio Kinopoisk | `GET /3/movie/550/ratings` | `kinopoisk` con `value` e `votes`, oppure null | | Testo in ucraino o bielorusso | `language=uk-UA` o `language=be-BY` | Campi localizzati, in inglese dove manca la traduzione | Il blocco seguente mostra una risposta di dettaglio in russo con `append_to_response=ratings`. È una risposta reale per Fight Club (id 550), ridotta ai campi usati qui e con la trama accorciata. ```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 } } } ``` L'oggetto ratings elenca sempre le stesse cinque chiavi. Qui il punteggio Kinopoisk è 8,7 e il suo `votes` è `null`, quindi il numero di voti di Kinopoisk non si può dare per scontato. I dettagli sono nella pagina [valutazioni](https://amodb.dev/it/ratings/). ## Confronto delle funzionalità | Funzionalità | Kinopoisk | amodb | | ---------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | | Modello di prezzo | Nessuna API aperta generica, per i servizi di terze parti vedi la loro documentazione | Prepagato, da 1 a 24 mesi per acquisto | | Piano gratuito | Vedi la loro documentazione | Nessuno, e nessuna prova | | Autenticazione | Vedi la loro documentazione | `api_key` o header Bearer | | Formato della risposta | Vedi la loro documentazione | JSON nel formato TMDB v3 | | Lingue | Sito in lingua russa | 14 lingue dell'interfaccia, russo compreso | | Film | Sul sito web | Dettagli, crediti, immagini, video | | Serie TV | Sul sito web | Serie, stagioni ed episodi | | Persone | Sul sito web | Profili e filmografia | | Immagini | Sul sito web | `img.amodb.dev`, senza chiave | | Valutazioni | Un proprio punteggio del pubblico sul sito web | Punteggio Kinopoisk più altre quattro fonti, quando sono note | | Limite di richieste | Vedi la loro documentazione | 20, 40 o 120 al minuto per chiave | | Uso commerciale | Vedi la loro documentazione | Piani a pagamento, vedi i [prezzi](https://amodb.dev/it/pricing/) | | Compatibilità | Nessuna API aperta generica, vedi la loro documentazione | Letture TMDB v3 e OMDb | ## Dove amodb è diverso - **Un contratto documentato.** Percorsi, parametri, corpi degli errori e limiti sono scritti nero su bianco, e una sola chiave serve tutti gli endpoint. - **Il russo accanto ad altre lingue.** La stessa chiamata con un altro valore di `language` restituisce gli stessi campi in un'altra lingua. È utile quando il tuo pubblico legge russo, ucraino e inglese. - **Più punteggi in un solo oggetto.** Puoi mostrare il punteggio Kinopoisk accanto a IMDb, Metacritic e Rotten Tomatoes, ciascuno `null` quando è sconosciuto. - **Titoli originali conservati.** `original_title` e `original_name` contengono il titolo nella lingua di origine, compresi giapponese e coreano, anche se non sono lingue dell'interfaccia. ## Dove Kinopoisk è più adatto - **La community stessa.** Recensioni, liste, pagine utente e discussioni locali vivono sul sito. amodb non offre nulla di tutto questo, solo il punteggio quando è noto. - **Tutto ciò che va oltre i metadati.** Per i contenuti che non sono un campo di metadati usa il sito stesso. Un'API di metadati non li trasporta. - **Il suo punteggio del pubblico.** Il valore nasce lì per primo. In amodb può essere `null` per un titolo nuovo o poco conosciuto, e il numero di voti può essere `null` anche quando il punteggio è impostato. ## Migrare ad amodb Raccogli gli ID Kinopoisk che conservi, associali una volta con `/3/find` e tieni accanto l'ID numerico di amodb. Poi richiedi i dettagli in russo e leggi il punteggio dalla stessa risposta. ```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") ``` Un array `movie_results` vuoto significa che per quell'ID non c'è corrispondenza. L'ID Kinopoisk di una serie riempie invece `tv_results`, quindi leggi entrambi gli array quando non conosci il tipo. Gestisci un 429 attendendo i secondi indicati da `Retry-After`. L'elenco delle lingue è nella pagina [lingue](https://amodb.dev/it/languages/) e le regole di ricerca nella pagina [ricerca per ID esterno](https://amodb.dev/it/find-by-external-id/). ## Gestire le lacune nel testo russo Un campo di testo può essere vuoto quando per un titolo non esiste una traduzione in russo. Controlla se la stringa è vuota e richiedi di nuovo quel titolo con `language=en-US`. Per le locandine con scritte in russo chiama `/3/movie/550/images?include_image_language=ru,null` e scegli da `posters`. Il valore `null` mantiene nell'elenco le immagini senza testo. Vedi [immagini](https://amodb.dev/it/images-api/) per le dimensioni. ## Prezzi amodb non ha un piano gratuito. Paghi in anticipo 1, 3, 6, 12 o 24 mesi su uno dei tre piani, e un periodo più lungo costa il 10, 20, 30 o 40 per cento in meno. I piani consentono 20, 40 o 120 richieste al minuto, restituiscono gli stessi dati e non si rinnovano automaticamente. Gli importi sono nella pagina [prezzi](https://amodb.dev/it/pricing/). ## Domande e risposte ### Kinopoisk ha un'API pubblica ufficiale? Kinopoisk è un sito di cinema in lingua russa e non pubblica un'API aperta generica. Gli sviluppatori usano spesso servizi di terze parti, ciascuno con le proprie condizioni. Controlla la loro documentazione prima di affidarti a uno di essi. ### Come trovo un titolo a partire da un ID Kinopoisk su amodb? Chiama /3/find con l'ID Kinopoisk e external_source=kinopoisk_id. Per esempio, 361 corrisponde a Fight Club, che ha id 550, e 404900 corrisponde a Breaking Bad, id 1396. Il risultato arriva in movie_results o tv_results, nel formato TMDB. ### La valutazione Kinopoisk viene sempre restituita? No. La chiave kinopoisk dell'oggetto ratings contiene value e votes quando il punteggio è noto, altrimenti null. Il valore è su 10 con un decimale. votes può essere null anche quando value è impostato, quindi mostralo solo se è presente. ### Quali lingue posso richiedere oltre al russo? Quattordici in tutto, tra cui ucraino e bielorusso. Invia un tag TMDB come uk-UA o be-BY nel parametro language. I tag non supportati ripiegano sull'inglese e i titoli originali restano in original_title. ### Ottengo il testo delle recensioni di Kinopoisk? No. amodb restituisce il punteggio Kinopoisk quando è noto. Il testo delle recensioni, le liste e le funzioni della community del sito non fanno parte dell'API, e l'endpoint reviews in stile TMDB restituisce una lista vuota per la maggior parte dei titoli. ## Pagine correlate - [API di metadati film multilingue](https://amodb.dev/it/multilingual-movie-metadata-api/): API di metadati film in 14 lingue. Usa i tag di lingua TMDB, leggi tutte le traduzioni, ripiega sull'inglese e gestisci l'ebraico da destra a sinistra. - [Valutazioni di film e serie TV](https://amodb.dev/it/ratings/): API valutazioni film: punteggi IMDb, Kinopoisk, Metacritic, Rotten Tomatoes e TMDB di un titolo in una chiamata, con null per le fonti non note. - [Ricerca per ID esterno](https://amodb.dev/it/find-by-external-id/): Cerca un film, una serie o una persona per ID IMDb, TVDB, Wikidata o Kinopoisk con l'endpoint find di TMDB, e leggi ID esterni e dati Wikidata di un titolo. - [Lingue](https://amodb.dev/it/languages/): amodb serve titoli, trame e nomi in 14 lingue. Passa un tag in stile TMDB come ru-RU o pt-BR in language; qualsiasi altro tag ripiega sull'inglese. - [Alternativa all'API IMDb](https://amodb.dev/it/imdb-api-alternative/): IMDb non ha un'API REST generica gratuita. Cerca un titolo con l'ID IMDb, leggi la valutazione IMDb quando c'è e ottieni cast, immagini e trailer. - [Prezzi](https://amodb.dev/it/pricing/): I piani amodb differiscono solo per le richieste al minuto: 20, 40 o 120. Ogni piano include tutti i dati TMDB v3 e OMDb. Prepagato, senza rinnovo né prova. Aggiornato: 2026-10-18. Source: https://amodb.dev/it/kinopoisk-api-alternative/