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"{
"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"{
"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"{
"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.
С чего начать?
С быстрого старта: там описано, как получить ключ и сделать первый запрос за пять минут.