Перейти к содержимому

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

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

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

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

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

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

Фильмы и сериалы — разные ID

У TMDB фильмы и сериалы пронумерованы отдельно: 27205 фильма и 27205 сериала — разные тайтлы. Поэтому в API это два типа ID: tmdb для фильмов и tmdb_tv для сериалов. Здесь — «Во все тяжкие»:

curl -H "X-API-Key: $KINODATA_KEY" \
  "https://api.kinodata.space/v1.3/ids/tmdb_tv/1396"
Ответ200
{
  "imdb_id": "tt0903747",
  "kp_id": "404900",
  "tmdb_id": null,
  "tmdb_tv_id": "1396",
  "kinorium_id": "400796"
}

В ответе заполнено ровно одно из полей tmdb_id и tmdb_tv_id: по нему видно, фильм это или сериал. Подробнее — в разделе ID во всех каталогах.

Карточка по ID TMDB

Тот же ID открывает карточку: названия, описание, жанры, страны, оценки TMDB, IMDb и Кинопоиска, состав, постеры и кадры, сезоны и серии.

curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "fields=title,type,synopsis" \
  "https://api.kinodata.space/v1.3/titles/tmdb/27205"
Ответ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"
    }
  },
  "title": {
    "title_ru": "Начало",
    "title_en": "Inception",
    "title_original": "Inception"
  },
  "type": {
    "kind": "movie",
    "is_series": false,
    "status": "released",
    "kind_label_ru": "Фильм",
    "kind_label_en": "Movie",
    "status_label_ru": "Вышел",
    "status_label_en": "Released"
  },
  "synopsis": {
    "tagline_ru": "Твой разум – место преступления",
    "tagline_en": "Your mind is the scene of the crime.",
    "overview_ru": "Кобб — талантливый вор, лучший из лучших в опасном искусстве извлечения: он крадет ценные секреты из глубин подсознания во время сна, когда человеческий разум наиболее уязвим. Редкие способности Кобба сделали его ценным игроком в привычном к предательству мире промышленного шпионажа, но они же превратили его в извечного беглеца и лишили всего, что он когда-либо любил. И вот у Кобба появляется шанс исправить ошибки. Его последнее дело может вернуть все назад, но для этого ему нужно совершить невозможное — инициацию. Вместо идеальной кражи Кобб и его команда спецов должны будут провернуть обратное. Теперь их задача — не украсть идею, а внедрить ее. Если у них получится, это и станет идеальным преступлением. Но никакое планирование или мастерство не могут подготовить команду к встрече с опасным противником, который, кажется, предугадывает каждый их ход. Врагом, увидеть которого мог бы лишь Кобб.",
    "overview_en": "Cobb, a skilled thief who commits corporate espionage by infiltrating the subconscious of his targets is offered a chance to regain his old life as payment for a task considered to be impossible: \"inception\", the implantation of another person's idea into a target's subconscious.",
    "short_overview_en": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
    "overview_alter_ru": "Мы привыкли, что в нашем понимании вор – это человек способный украсть какие-то ценности или деньги. Сюжет картины рассказывает о ворах, способных украсть идею прямо у человека из подсознания. Одним из таких является главный герой фильма Доминик Кобб. После того, как его жена умерла, он вынужден скрываться, и не может даже вернуться в страну, чтобы повидать детей. Как-то раз Кобб получает очень неординарный заказ: ему нужно не украсть, а наоборот внедрить новую идею в подсознание человека. Доминику не очень хочется браться за это дело, но заказчик в обмен предлагает возможность вернуться домой. Заручившись поддержкой профессионалов этого дела, Кобб начинает разрабатывать план, как все провернуть. Все нужно очень хорошо продумать, ведь ворам предстоит воссоздать многослойную реальность в подсознании объекта, в результате чего грани могут начать стираться.",
    "overview_alter_en": null,
    "short_overview_ru": "Профессиональные воры внедряются в сон наследника огромной империи. Фантастический боевик Кристофера Нолана"
  }
}

Все поля — в справочнике карточки.

Вопросы

Это официальный API TMDB?

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

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

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

Как перевести ID TMDB в ID IMDb?

Запросом /v1.3/ids/tmdb/<ID> для фильма или /v1.3/ids/tmdb_tv/<ID> для сериала: в ответе есть imdb_id, а также kp_id и kinorium_id.

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

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