Skip to content
kinodata
Log inSign up
kinodata

TMDB API: TMDB IDs to IMDb, Kinopoisk and Kinorium

Get API keyDocumentation

kinodata links a TMDB ID to the same title's IDs on IMDb, Kinopoisk and Kinorium, and serves the movie or series card in English and Russian. It's plain REST with JSON responses and one key for every request.

kinodata is an independent service. It isn't the official TMDB API and isn't affiliated with The Movie Database.

TMDB IDs to IMDb, Kinopoisk and Kinorium

One request by a TMDB movie ID returns the title's IDs in every catalog. Here it's Inception, 27205:

curl -H "X-API-Key: $KINODATA_KEY" \
  "https://api.kinodata.space/v1.3/ids/tmdb/27205"
Response200
{
  "imdb_id": "tt1375666",
  "kp_id": "447301",
  "tmdb_id": "27205",
  "tmdb_tv_id": null,
  "kinorium_id": "472809"
}

Movies and series have separate IDs

TMDB numbers movies and series separately: movie 27205 and series 27205 are different titles. So the API has two ID types: tmdb for movies and tmdb_tv for series. Here it's Breaking Bad:

curl -H "X-API-Key: $KINODATA_KEY" \
  "https://api.kinodata.space/v1.3/ids/tmdb_tv/1396"
Response200
{
  "imdb_id": "tt0903747",
  "kp_id": "404900",
  "tmdb_id": null,
  "tmdb_tv_id": "1396",
  "kinorium_id": "400796"
}

Exactly one of tmdb_id and tmdb_tv_id is filled in, and it tells you whether the title is a film or a series. More in IDs across catalogs.

The card by TMDB ID

The same ID opens the card: titles, overview, genres, countries, TMDB, IMDb and Kinopoisk ratings, cast, posters and stills, seasons and episodes.

curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "fields=title,type,synopsis" \
  --data-urlencode "lang=en" \
  "https://api.kinodata.space/v1.3/titles/tmdb/27205"
Response200
{
  "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://en.kinorium.com/472809/",
      "kp": "https://www.kinopoisk.ru/film/447301/",
      "tmdb": "https://www.themoviedb.org/movie/27205"
    }
  },
  "title": {
    "title_en": "Inception",
    "title_original": "Inception"
  },
  "type": {
    "kind": "movie",
    "is_series": false,
    "status": "released",
    "kind_label_en": "Movie",
    "status_label_en": "Released"
  },
  "synopsis": {
    "tagline_en": "Your mind is the scene of the crime.",
    "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_en": null
  }
}

Every field is in the title card reference.

Questions

Is this the official TMDB API?

No. kinodata is an independent service, not affiliated with The Movie Database. We link one title's IDs across catalogs and gather its data into one card.

How much does it cost?

The Free plan gives 500 requests a day and 10 a second, no card needed. Basic and Business give more; see Pricing.

How do I convert a TMDB ID to an IMDb ID?

With /v1.3/ids/tmdb/<ID> for a film or /v1.3/ids/tmdb_tv/<ID> for a series: the response has imdb_id, as well as kp_id and kinorium_id.

Where do I start?

With the quickstart: an API key and your first request in five minutes.