Перейти к содержимому
kinodata
ВойтиРегистрация
kinodata

API Кинориума: ID, оценки и данные фильмов

Получить ключДокументация

kinodata отдаёт данные о фильмах и сериалах по ID Кинориума. По одному ID вы получаете ID того же тайтла в IMDb, Кинопоиске и TMDB, оценку и голоса Кинориума рядом с оценками других каталогов и карточку на русском и английском. Это обычный REST с ответами в JSON и один ключ на все запросы.

kinodata — независимый сервис. Это не официальный API Кинориума, и с Кинориумом он не связан.

ID Кинориума в IMDb, Кинопоиск и TMDB

Один запрос по ID Кинориума возвращает ID тайтла во всех каталогах. Здесь это «Начало», 472809:

curl -H "X-API-Key: $KINODATA_KEY" \
  "https://api.kinodata.space/v1.3/ids/kinorium/472809"
Ответ200
{
  "imdb_id": "tt1375666",
  "kp_id": "447301",
  "tmdb_id": "27205",
  "tmdb_tv_id": null,
  "kinorium_id": "472809"
}

Связка работает в обе стороны: kinorium_id есть в ответе на запрос по ID любого другого каталога. Подробнее — в разделе ID во всех каталогах.

Лучшие фильмы по оценке Кинориума

Оценка Кинориума — поле rating_kr, по нему каталог сортирует и фильтрует. Три фильма с лучшей оценкой среди тех, у кого больше 20 000 голосов на Кинориуме:

curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "kind=movie" \
  --data-urlencode "votes_kr.gte=20000" \
  --data-urlencode "sort=-rating_kr" \
  --data-urlencode "limit=3" \
  --data-urlencode "fields=title,year,rating_kr" \
  "https://api.kinodata.space/v1.3/titles"
Ответ200
{
  "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_kr": 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_kr": 8.9
    },
    {
      "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_kr": 8.8
    }
  ],
  "limit": 3,
  "offset": 0,
  "total": null
}

Оценки всех каталогов рядом

Блок ratings карточки собирает оценки Кинориума, Кинопоиска, IMDb, TMDB, Letterboxd, Rotten Tomatoes и Metacritic, у каждой — голоса и ссылка на страницу тайтла:

curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "fields=ratings" \
  "https://api.kinodata.space/v1.3/titles/kp/447301"
Ответ200
{
  "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
  }
}

Метки, цитаты и факты

С Кинориума приходят метки настроения, ключевые слова и поджанры, а ещё цитаты и факты на русском. Метки работают и как фильтр каталога. Цитаты и факты отдаёт /texts, метки — блок tags карточки.

Вопросы

Это официальный API Кинориума?

Нет. kinodata — независимый сервис, не связанный с Кинориумом. Мы связываем ID одного тайтла в разных каталогах и собираем данные о нём в одну карточку.

Сколько это стоит?

На тарифе Free — 500 запросов в сутки и 10 в секунду, карта не нужна. Basic и Business дают больше запросов, условия — на странице Тарифы.

Как найти фильм без ID Кинориума?

Поиском по названию: /v1.3/titles?q=начало. Поиск прощает опечатки и находит тайтл по названию на другом языке. В ответе — ID Кинориума и остальных каталогов.

С чего начать?

С быстрого старта: там описано, как получить ключ и сделать первый запрос за пять минут.