IDs in every catalog
GET/v1.3/ids/{type}/{id}
Takes a title’s ID in one catalog and returns its IDs in the others.
The lightest request in the API: IDs only, without titles or metadata. Use it when you need the IDs for your own database or to open the title on a catalog site.
tmdb and tmdb_tv are separate ID spaces. The same number means different works in each: /ids/tmdb/1396 is Tarkovsky’s Mirror, /ids/tmdb_tv/1396 is Breaking Bad. Use the type TMDB itself gave you.
Path parameters
typestringrequiredThe catalog the ID comes from: IMDb, Kinopoisk, TMDB (movie or series) or Kinorium.
imdbkptmdbtmdb_tvkinoriumidstringrequiredThe ID in that catalog. IMDb IDs are
ttfollowed by digits (tt1375666); the others are digits (447301).
Response fields
imdb_idstring | nullIMDb ID:
ttfollowed by digits.kp_idstring | nullKinopoisk ID.
tmdb_idstring | nullTMDB movie ID.
nullfor a series: its ID is intmdb_tv_id.tmdb_tv_idstring | nullTMDB series ID. At most one of
tmdb_idandtmdb_tv_idis set.kinorium_idstring | nullKinorium ID.
Errors
| status | code | when |
|---|---|---|
| 400 | invalid_request | Unknown |
| 404 | not_found | No title found for this ID. |
| 401 | unauthorized | The |
| 429 | rate_limited | The per-second rate limit or the daily quota is used up. |
Every code and what to do about it is on the Errors page.