# Alternative à l'API Kinopoisk

> Kinopoisk est un site de cinéma en langue russe et ne publie pas d'API ouverte généraliste. Les développeurs se tournent souvent vers des services tiers, consultez leur documentation. amodb est une API payante qui renvoie les titres en russe avec language=ru-RU, retrouve un titre par identifiant Kinopoisk et inclut la note Kinopoisk quand elle est connue.

## Ce qu'une alternative peut et ne peut pas vous apporter

Kinopoisk est un site de cinéma en langue russe et il ne publie pas d'API ouverte généraliste. Les développeurs se tournent souvent vers des services tiers, chacun avec ses propres conditions, consultez donc leur documentation. amodb est une API indépendante et non un service Kinopoisk. Elle répond à trois besoins fréquents des projets en russe : titres et résumés en russe, recherche par identifiant Kinopoisk, et note Kinopoisk à côté des autres notes quand elle est connue.

## Les briques de base

| Vous avez besoin de                          | Comment                                              | Ce que vous recevez                                   |
| -------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------- |
| Titre et résumé en russe                     | `language=ru-RU` sur n'importe quel appel de détails | `title` en russe, `original_title` inchangé           |
| Un titre à partir d'un identifiant Kinopoisk | `GET /3/find/361?external_source=kinopoisk_id`       | `movie_results` avec l'id 550                         |
| L'identifiant Kinopoisk d'un titre           | `GET /3/movie/550/external_ids`                      | `kinopoisk_id` sous forme de chaîne, `"361"` ici      |
| La note Kinopoisk                            | `GET /3/movie/550/ratings`                           | `kinopoisk` avec `value` et `votes`, ou null          |
| Du texte en ukrainien ou en biélorusse       | `language=uk-UA` ou `language=be-BY`                 | Champs localisés, anglais quand il n'y a rien d'autre |

Le bloc suivant montre une réponse de détails en russe avec `append_to_response=ratings`. C'est une vraie réponse pour Fight Club (id 550), réduite aux champs utilisés ici, avec un résumé raccourci.

```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'objet ratings liste toujours les mêmes cinq clés. Ici, la note Kinopoisk est de 8,7 et son `votes` vaut `null` : on ne peut donc pas tenir pour acquis un nombre de votes Kinopoisk. Les détails sont sur la page [notes](https://amodb.dev/fr/ratings/).

## Comparatif des fonctionnalités

| Fonctionnalité    | Kinopoisk                                                               | amodb                                                             |
| ----------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Modèle tarifaire  | Pas d'API ouverte généraliste, voir la documentation des services tiers | Prépayé, de 1 à 24 mois par achat                                 |
| Offre gratuite    | Voir leur documentation                                                 | Aucune, et pas d'essai                                            |
| Authentification  | Voir leur documentation                                                 | `api_key` ou en-tête Bearer                                       |
| Format de réponse | Voir leur documentation                                                 | JSON au format TMDB v3                                            |
| Langues           | Site en langue russe                                                    | 14 langues d'interface, dont le russe                             |
| Films             | Sur le site web                                                         | Détails, distribution, images, vidéos                             |
| Séries            | Sur le site web                                                         | Séries, saisons et épisodes                                       |
| Personnes         | Sur le site web                                                         | Profils et filmographie                                           |
| Images            | Sur le site web                                                         | `img.amodb.dev`, sans clé                                         |
| Notes             | Sa propre note du public sur le site web                                | Note Kinopoisk et quatre autres sources quand elles sont connues  |
| Limite de débit   | Voir leur documentation                                                 | 20, 40 ou 120 par minute et par clé                               |
| Usage commercial  | Voir leur documentation                                                 | Offres payantes, voir les [tarifs](https://amodb.dev/fr/pricing/) |
| Compatibilité     | Pas d'API ouverte généraliste, voir leur documentation                  | Lectures TMDB v3 et OMDb                                          |

## Ce qui distingue amodb

- **Un contrat documenté.** Les chemins, les paramètres, les corps d'erreur et les limites sont écrits noir sur blanc, et une seule clé sert tous les points de terminaison.
- **Le russe à côté d'autres langues.** Le même appel avec une autre valeur de `language` renvoie les mêmes champs dans une autre langue. C'est utile quand votre public lit le russe, l'ukrainien et l'anglais.
- **Plusieurs notes dans un seul objet.** Vous pouvez afficher la note Kinopoisk à côté d'IMDb, de Metacritic et de Rotten Tomatoes, chacune valant `null` quand elle est inconnue.
- **Titres originaux conservés.** `original_title` et `original_name` contiennent le titre dans sa langue d'origine, y compris le japonais et le coréen, même s'il ne s'agit pas de langues d'interface.

## Quand Kinopoisk convient mieux

- **La communauté elle-même.** Les critiques, les listes, les pages d'utilisateurs et les discussions locales vivent sur le site. amodb n'offre rien de tout cela, seulement la note quand elle est connue.
- **Tout ce qui dépasse les métadonnées.** Pour un contenu qui n'est pas un champ de métadonnées, utilisez le site lui-même. Une API de métadonnées ne le transporte pas.
- **Sa propre note du public.** La valeur y est produite en premier. Dans amodb, elle peut valoir `null` pour un titre récent ou peu connu, et le nombre de votes peut valoir `null` même quand la note est renseignée.

## Migrer vers amodb

Rassemblez les identifiants Kinopoisk que vous stockez, associez-les une fois avec `/3/find` et conservez l'identifiant numérique amodb à côté. Ensuite, demandez les détails en russe et lisez la note dans la même réponse.

```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 tableau `movie_results` vide signifie qu'aucun titre ne correspond à cet identifiant. L'identifiant Kinopoisk d'une série remplit `tv_results` à la place : lisez donc les deux tableaux quand vous ne connaissez pas le type. Pour une réponse 429, attendez le nombre de secondes indiqué par `Retry-After`. La liste des langues est sur [langues](https://amodb.dev/fr/languages/), et les règles de recherche sont sur [recherche par identifiant externe](https://amodb.dev/fr/find-by-external-id/).

## Gérer les manques dans le texte russe

Un champ de texte peut être vide quand il n'existe pas de traduction russe pour un titre. Testez la chaîne vide et redemandez ce titre avec `language=en-US`. Pour les affiches avec du texte en russe, appelez `/3/movie/550/images?include_image_language=ru,null` et choisissez dans `posters`. La valeur `null` garde dans la liste les visuels sans texte. Voir [images](https://amodb.dev/fr/images-api/) pour les tailles.

## Tarifs

amodb n'a pas d'offre gratuite. Vous payez d'avance 1, 3, 6, 12 ou 24 mois sur l'une des trois offres, et une période plus longue coûte 10, 20, 30 ou 40 pour cent de moins. Les offres autorisent 20, 40 ou 120 requêtes par minute, renvoient les mêmes données et ne se renouvellent pas automatiquement. Les montants sont sur les [tarifs](https://amodb.dev/fr/pricing/).

## Questions et réponses

### Kinopoisk a-t-il une API publique officielle ?

Kinopoisk est un site de cinéma en langue russe et ne publie pas d'API ouverte généraliste. Les développeurs utilisent souvent des services tiers, chacun avec ses propres conditions. Consultez leur documentation avant de vous appuyer sur l'un d'eux.

### Comment retrouver un titre à partir d'un identifiant Kinopoisk sur amodb ?

Appelez /3/find avec l'identifiant Kinopoisk et external_source=kinopoisk_id. Par exemple, 361 donne Fight Club, qui a l'id 550, et 404900 donne Breaking Bad, id 1396. Le résultat arrive dans movie_results ou tv_results, au format TMDB.

### La note Kinopoisk est-elle toujours renvoyée ?

Non. La clé kinopoisk de l'objet ratings contient value et votes quand la note est connue, et null sinon. La valeur est sur 10 avec une décimale. votes peut valoir null même si value est renseignée : n'affichez les votes que s'ils sont présents.

### Quelles langues puis-je demander en plus du russe ?

Quatorze au total, dont l'ukrainien et le biélorusse. Envoyez une balise TMDB comme uk-UA ou be-BY dans le paramètre language. Les balises non prises en charge se replient sur l'anglais, et les titres originaux restent dans original_title.

### Obtient-on le texte des critiques Kinopoisk ?

Non. amodb renvoie la note Kinopoisk quand elle est connue. Le texte des critiques, les listes et les fonctions communautaires du site ne font pas partie de l'API, et le point de terminaison reviews de type TMDB renvoie une liste vide pour la plupart des titres.

## Pages liées

- [API de métadonnées de films multilingue](https://amodb.dev/fr/multilingual-movie-metadata-api/): API de métadonnées de films en 14 langues. Balises de langue TMDB, toutes les traductions, repli sur l'anglais et gestion de l'hébreu de droite à gauche.
- [Notes des films et séries](https://amodb.dev/fr/ratings/): API de notes de films : scores IMDb, Kinopoisk, Metacritic, Rotten Tomatoes et TMDB d'un titre en un appel, avec null pour toute source inconnue.
- [Recherche par identifiant externe](https://amodb.dev/fr/find-by-external-id/): Retrouvez un film, une série ou une personne par id IMDb, TVDB, Wikidata ou Kinopoisk avec find de TMDB, puis lisez ids externes et faits Wikidata.
- [Langues](https://amodb.dev/fr/languages/): amodb sert titres, résumés et noms en 14 langues. Passez une balise TMDB comme ru-RU ou pt-BR dans language ; toute autre balise se replie sur l'anglais.
- [Alternative à l'API IMDb](https://amodb.dev/fr/imdb-api-alternative/): IMDb n'a pas d'API REST généraliste gratuite. Trouvez un titre par identifiant IMDb, lisez sa note IMDb et récupérez casting, images et bandes-annonces.
- [Tarifs](https://amodb.dev/fr/pricing/): Les offres amodb ne diffèrent que par les requêtes par minute : 20, 40 ou 120. Toutes incluent les données TMDB v3 et OMDb. Prépayé, sans renouvellement.

Mis à jour: 2026-10-18. Source: https://amodb.dev/fr/kinopoisk-api-alternative/