Kinopoisk API: IDs, ratings and movie data
kinodata serves movie and series data by Kinopoisk ID. One ID gets you the same title's IDs on IMDb, TMDB and Kinorium, the Kinopoisk rating and votes next to the other catalogs' ratings, and a card in English and Russian. It's plain REST with JSON responses and one key for every request.
kinodata is an independent service. It isn't the official Kinopoisk API and isn't affiliated with Kinopoisk or Yandex.
Kinopoisk IDs to IMDb, TMDB and Kinorium
One request by Kinopoisk ID returns the title's IDs in every catalog. Here it's Inception, 447301:
curl -H "X-API-Key: $KINODATA_KEY" \
"https://api.kinodata.space/v1.3/ids/kp/447301"{
"imdb_id": "tt1375666",
"kp_id": "447301",
"tmdb_id": "27205",
"tmdb_tv_id": null,
"kinorium_id": "472809"
}
It works both ways: the same request by an IMDb, TMDB or Kinorium ID returns the Kinopoisk ID. More in IDs across catalogs.
Kinopoisk rating next to the others
The card's ratings block brings together Kinopoisk, IMDb, TMDB, Kinorium, Letterboxd, Rotten Tomatoes, Metacritic and critics, each with its votes and a link to the title's page:
curl -G -H "X-API-Key: $KINODATA_KEY" \
--data-urlencode "fields=ratings" \
"https://api.kinodata.space/v1.3/titles/kp/447301"{
"ids": {
"imdb_id": "tt1375666",
"kp_id": "447301",
"tmdb_id": "27205",
"tmdb_tv_id": null,
"kinorium_id": "472809",
"urls": {
"imdb": "https://www.imdb.com/title/tt1375666/",
"kinorium": "https://ru.kinorium.com/472809/",
"kp": "https://www.kinopoisk.ru/film/447301/",
"tmdb": "https://www.themoviedb.org/movie/27205"
}
},
"ratings": {
"sources": {
"cr": {
"value": 92,
"votes": 13,
"scale": 100
},
"critics": {
"value": 8.4,
"votes": 363,
"scale": 10,
"kind": "critics"
},
"imdb": {
"value": 8.8,
"votes": 2877173,
"scale": 10,
"url": "https://www.imdb.com/title/tt1375666/"
},
"kinorium": {
"value": 8.6,
"votes": 27048,
"scale": 10,
"url": "https://ru.kinorium.com/472809/",
"distribution": [
27,
26,
59,
104,
280,
695,
2003,
4409,
5332,
5577
]
},
"kp": {
"value": 8.7,
"votes": 1132562,
"scale": 10,
"url": "https://www.kinopoisk.ru/film/447301/"
},
"letterboxd": {
"value": 8.4,
"votes": 3604328,
"scale": 10
},
"metacritic": {
"value": 74,
"votes": 42,
"scale": 100,
"kind": "critics"
},
"rt": {
"value": 86,
"votes": 364,
"scale": 100,
"kind": "critics"
},
"tmdb": {
"value": 8.4,
"votes": 40402,
"scale": 10,
"url": "https://www.themoviedb.org/movie/27205"
}
},
"votes_total": 4050137,
"divergence_kp_imdb": 0.1,
"popularity": 50.947
}
}
The best films by Kinopoisk rating
The catalog sorts and filters by any source's rating and vote count. The three films with the best Kinopoisk rating among those with over 100,000 votes:
curl -G -H "X-API-Key: $KINODATA_KEY" \
--data-urlencode "kind=movie" \
--data-urlencode "votes_kp.gte=100000" \
--data-urlencode "sort=-rating_kp" \
--data-urlencode "limit=3" \
--data-urlencode "fields=title,year,rating_kp" \
"https://api.kinodata.space/v1.3/titles"{
"has_more": true,
"items": [
{
"imdb_id": "tt0111161",
"kp_id": "326",
"tmdb_id": "278",
"tmdb_tv_id": null,
"kinorium_id": "101209",
"title_ru": "Побег из Шоушенка",
"title_en": "The Shawshank Redemption",
"year": 1994,
"rating_kp": 9.1
},
{
"imdb_id": "tt0120689",
"kp_id": "435",
"tmdb_id": "497",
"tmdb_tv_id": null,
"kinorium_id": "109273",
"title_ru": "Зелёная миля",
"title_en": "The Green Mile",
"year": 1999,
"rating_kp": 9.1
},
{
"imdb_id": "tt0109830",
"kp_id": "448",
"tmdb_id": "13",
"tmdb_tv_id": null,
"kinorium_id": "99975",
"title_ru": "Форрест Гамп",
"title_en": "Forrest Gump",
"year": 1994,
"rating_kp": 8.9
}
],
"limit": 3,
"offset": 0,
"total": null
}
The other filters — genres, countries, years, people, collections — are in Filters and sorting.
What else the card has
Titles in English and Russian, overview and tagline, genres and countries, age rating, seasons and episodes, cast and crew, posters and stills, facts and quotes, similar titles and franchises. Every field is in the title card reference.
Questions
Is this the official Kinopoisk API?
No. kinodata is an independent service, not affiliated with Kinopoisk or Yandex. We link one title's IDs across catalogs and gather its data into one card.
How much does it cost?
The Free plan gives 500 requests a day and 10 a second, no card needed. Basic and Business give more; see Pricing.
How do I find a film without its Kinopoisk ID?
Search by title: /v1.3/titles?q=inception. Search forgives typos and finds a title by its name in another language. The response has the Kinopoisk ID and the other catalogs' IDs.
Are TV series included?
Yes. Series are in the same catalog with kind=series, and /episodes serves their seasons and episodes.
Where do I start?
With the quickstart: an API key and your first request in five minutes.