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_tvkinoriumidstringобязательныйID в этом каталоге. У IMDb —
ttи цифры (tt1375666), у остальных — цифры (447301).
Поля ответа
imdb_idstring | nullID в IMDb:
ttи цифры.kp_idstring | nullID на Кинопоиске.
tmdb_idstring | nullID фильма в TMDB. У сериала —
null, его ID вtmdb_tv_id.tmdb_tv_idstring | nullID сериала в TMDB. Заполнено не больше одного из
tmdb_idиtmdb_tv_id.kinorium_idstring | nullID на Кинориуме.
Ошибки
| статус | код | когда |
|---|---|---|
| 400 | invalid_request | Неизвестный |
| 404 | not_found | Тайтл с таким ID не найден. |
| 401 | unauthorized | Нет заголовка |
| 429 | rate_limited | Исчерпан предел в секунду или квота на сутки. |
Все коды и что с ними делать — на странице Ошибки.