Skip to content
Sections: IDs in every catalog

Reference

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

  • typestringrequired

    The catalog the ID comes from: IMDb, Kinopoisk, TMDB (movie or series) or Kinorium.

    imdbkptmdbtmdb_tvkinorium
  • idstringrequired

    The ID in that catalog. IMDb IDs are tt followed by digits (tt1375666); the others are digits (447301).

Response fields

  • imdb_idstring | null

    IMDb ID: tt followed by digits.

  • kp_idstring | null

    Kinopoisk ID.

  • tmdb_idstring | null

    TMDB movie ID. null for a series: its ID is in tmdb_tv_id.

  • tmdb_tv_idstring | null

    TMDB series ID. At most one of tmdb_id and tmdb_tv_id is set.

  • kinorium_idstring | null

    Kinorium ID.

Errors

statuscodewhen
400invalid_request

Unknown type, or the ID does not match the catalog format: no tt for IMDb, not digits for the rest; a query parameter other than lang.

404not_found

No title found for this ID.

401unauthorized

The X-API-Key header is missing, or the key is unknown or revoked.

429rate_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.

Esc

Loading the index…

    ↑ ↓ to selectEnter to openEsc to close