Перейти к содержимому
Разделы: ID во всех каталогах

Справочник

ID во всех каталогах

GET/v1.3/ids/{type}/{id}

По ID тайтла в одном каталоге — его ID в остальных.

Самый лёгкий запрос API: только ID, без названий и метаданных. Подходит, когда ID нужны для своей базы или чтобы открыть тайтл на сайте каталога.

tmdb и tmdb_tv — разные пространства ID. Один и тот же ID означает в них разные произведения: /ids/tmdb/1396 — «Зеркало» Тарковского, /ids/tmdb_tv/1396 — «Во все тяжкие». Берите тип, который дал вам сам TMDB.

Параметры пути

  • typestringобязательный

    Каталог, из которого ID: IMDb, Кинопоиск, TMDB (фильм или сериал) или Кинориум.

    imdbkptmdbtmdb_tvkinorium
  • idstringобязательный

    ID в этом каталоге. У IMDb — tt и цифры (tt1375666), у остальных — цифры (447301).

Поля ответа

  • imdb_idstring | null

    ID в IMDb: tt и цифры.

  • kp_idstring | null

    ID на Кинопоиске.

  • tmdb_idstring | null

    ID фильма в TMDB. У сериала — null, его ID в tmdb_tv_id.

  • tmdb_tv_idstring | null

    ID сериала в TMDB. Заполнено не больше одного из tmdb_id и tmdb_tv_id.

  • kinorium_idstring | null

    ID на Кинориуме.

Ошибки

статускодкогда
400invalid_request

Неизвестный type или ID не в формате каталога: у IMDb нет tt, у остальных не цифры; параметр запроса, кроме lang.

404not_found

Тайтл с таким ID не найден.

401unauthorized

Нет заголовка X-API-Key, ключ неизвестен или отозван.

429rate_limited

Исчерпан предел в секунду или квота на сутки.

Все коды и что с ними делать — на странице Ошибки.

Esc

Загружаем оглавление…

    ↑ ↓ выбратьEnter открытьEsc закрыть