Related titles

GET/v1.3/titles/{type}/{id}/relations

Similar titles, the franchise, references to other films and mentions in them.

The examples on the right use The Lord of the Rings: The Fellowship of the Ring (kp 328), which has a franchise, similar titles and references. Relations come in four kinds:

• similar: similar titles;
• related: the franchise, meaning sequels, prequels, spin-offs and remakes. They come by release year, like a timeline;
• reference: films this title references;
• referenced_in: where this title is mentioned.

Without parameters you get four sections of 10 titles each. relation=similar gives a flat, pageable list. An item is the same card as in the catalog, and the same filters and sorting work here.

When a title has no “similar” relations at all, relation=similar picks neighbours by its description: the same kind, the same genres, nearby years. Such a response carries basis: "content" and its total is null. These are neighbours, not recommendations; tell them apart from a regular list.

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).

Query parameters

• relationcsv

  Kinds of relation, comma-separated. One kind gives a flat, pageable list.

  similarrelatedreferencereferenced_in
  Default:

  all four

  Example: relation=related
• subtypecsv

  Narrows the franchise (related) to a kind of link.

  sequelprequelspinoffparentchronologyremakeoriginalversion
  Example: subtype=sequel
• sourceenum

  Keep the relations this catalog provided.

  kinoriumkptmdb
  Example: source=kp
• filters and sort

  The catalog’s filters and sorting: sort=-rating_imdb, votes_imdb.gte=100000, year.gte=2000. Details in Filters and sorting.

• fieldscsv

  Which item fields to return, as in the catalog. IDs always come back.

  Example: fields=title,year
• groupenum

  Split the list into sections. none gives a flat list. How sections work is in Lists and pagination.

  relationnone
  Default:

  relation

• langru | en

  Keep one language in the response. Without it, text fields come in _ru and _en pairs. More in Response languages.

  Example: lang=en
• limitinteger

  How many items to return, a whole number from 1. With sections, per section, up to 50. In a flat list, up to 1000. Above the cap isn’t an error: the API lowers it and shows the value in limit.

  Default:

  10 per section, 1000 in a flat list

  Example: limit=20
• offsetinteger

  How many items to skip, a whole number from 0. Only in a flat list: with sections it returns 400.

  Default:

  0

Response fields

• countsobject

  How many relations of each kind: similar, related, reference, referenced_in. Doesn’t depend on relation, so you can label tabs with it. source and subtype narrow the counts too.

• basisstring

  content when similar titles were picked by description. A regular list has no such field.

• itemsarray

  Titles. With sections, sections with their own relation, labels, total and items.

  +−Show 26 fields

  • imdb_id · kp_id · tmdb_id · tmdb_tv_id · kinorium_idstring | null

    The title’s catalog IDs. Always returned, even with fields.

  • title_ru · title_en · title_originalstring | null

    Titles: Russian, English and in the original language.

  • yearinteger | null

    Release year.

  • release_datestring | null

    First release date, YYYY-MM-DD.

  • kindenum

    Kind of title: movie, series, mini_series, tv_show, anime, cartoon, short.

  • poster_url_ru · poster_url_enstring | null

    Poster for a Russian and an English storefront.

  • posters_by_sourceobject

    Each source’s poster: kp, tmdb, imdb, kinorium.

  • rating_kp · rating_tmdb · rating_imdb · rating_kr · rating_letterboxdnumber | null

    Kinopoisk, TMDB, IMDb, Kinorium and Letterboxd ratings, 0–10 scale.

  • votes_kp · votes_tmdb · votes_imdbinteger | null

    Kinopoisk, TMDB and IMDb votes.

  • countriesarray

    Countries: code, name_ru, name_en.

  • genresarray

    Genres: slug, name_ru, name_en.

  • relationenum

    Kind of relation.

  • subtypeenum | null

    How two franchise titles are linked. null means the source didn’t say.

    sequelprequelspinoffparentchronologyremakeoriginalversion
• total · limit · offset · has_more

  Paging, as in every list. With filters, total is null.

Errors