Title card

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

Everything about a movie or series in one request: titles, overviews, ratings, dates, awards, media and cast.

The card opens by an ID from any of the five catalogs: /titles/kp/447301 and /titles/imdb/tt1375666 return the same thing.

The full card has up to 22 blocks and is about 26 KB, about 8 KB compressed. If you need part of it, list the blocks in fields: the response gets smaller and easier to parse. The ids block always comes back.

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

• fieldscsv

  Which blocks to return: fields=title,ratings. With a - sign, which to drop: fields=-akas,-tags. The two can’t be mixed. All blocks by default.

  idsmetatitletypesynopsisreleaseratingsfinanceawardscountriesclassificationseriesmediagenrescompaniesakastagswatchparentalcredits_topfranchisecounts
  Example: fields=title,ratings
• langru | en

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

Response fields

• idsobject

  The title's IDs in every catalog and links to its pages. Always returned, even if it isn't in fields.

  +−Show 6 fields

  • imdb_idstring | null

    IMDb ID.

  • kp_idstring | null

    Kinopoisk ID.

  • tmdb_idstring | null

    TMDB movie 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.

  • urlsobject

    Links to the title’s pages: imdb, kp, tmdb, kinorium. With lang=en the Kinorium link points to en.kinorium.com.

• metaobject

  Service information about the card.

  +−Show 1 field

  • updated_atstring

    When the title’s data was last updated, ISO 8601 in UTC.

• titleobject

  Titles.

  +−Show 3 fields

  • title_rustring | null

    Russian title.

  • title_enstring | null

    English title. Only a real one: the original title of a non-English film or a transliteration never goes here, and then it is null.

  • title_originalstring | null

    Title in the original language.

• typeobject

  Kind and status of the title.

  +−Show 7 fields

  • kindenum

    Kind of title.

    movieseriesmini_seriestv_showanimecartoonshort
  • is_seriesboolean

    Whether the title has episodes.

  • statusenum

    Release status. Every value is in /enums, set statuses.

    releasedendedreturning_seriesin_productionpost_productionin_developmentplannedcanceled
  • kind_label_ru · kind_label_enstring

    Kind label: «Фильм» / «Movie».

  • status_label_ru · status_label_enstring

    Status label: «Вышел» / «Released».

• synopsisobject

  Overviews and taglines. Each text comes from its own source rather than being a translation of the other.

  +−Show 8 fields

  • overview_ru · overview_enstring | null

    Plot overview.

  • short_overview_ru · short_overview_enstring | null

    A one- or two-sentence overview.

  • tagline_ru · tagline_enstring | null

    Tagline.

  • overview_alter_ru · overview_alter_enstring | null

    A second overview from another source, when it differs from the first.

• releaseobject

  Year, runtime and release dates.

  +−Show 3 fields

  • yearinteger | null

    Release year.

  • runtimeinteger | null

    Runtime in minutes.

  • releasesarray

    Release dates by region. Each date appears once: if the US digital release matches the worldwide one, it is only under world.

    +−Show 2 fields

    • regionstring

      Region: world is the earliest date worldwide, us is the US, ru is Russia.

    • datesarray

      Dates in the region: type and date. Types: premiere, release for the theatrical release, digital; labels are in /enums, set title_release_types. Dates are YYYY-MM-DD.

• ratingsobject

  Ratings by source. There is no overall score on purpose: sources have different scales and audiences.

  +−Show 4 fields

  • sourcesobject

    Ratings by source: the key is the source (imdb, kp, tmdb, kinorium, letterboxd, rt, metacritic, critics, cr), the value has value, votes, scale (10 or 100), kind: "critics" for critics’ scores and the page url. Kinorium also has distribution: how many viewers gave each score from 1 to 10. Kinorium counts it separately, so its sum doesn’t match votes. Source labels are in /enums, set rating_sources. No source, no key.

  • votes_totalinteger | null

    Kinopoisk, IMDb and TMDB votes combined.

  • divergence_kp_imdbnumber | null

    How far the Kinopoisk and IMDb ratings are apart, as an absolute value.

  • popularitynumber | null

    TMDB’s popularity index. It is not a vote count.

• financeobject

  Money, in US dollars.

  +−Show 3 fields

  • budgetinteger | null

    Budget.

  • box_office_usinteger | null

    US box office.

  • revenue_worldinteger | null

    Worldwide box office.

• awardsobject

  Awards: totals and a breakdown by ceremony.

  +−Show 9 fields

  • wins_imdb · nominations_imdbinteger | null

    Wins and all nominations, including the won ones, according to IMDb, across every award worldwide.

  • oscars_won · oscars_nominatedinteger | null

    Oscars: wins and all nominations, including the won ones.

  • wins_ceremonies · nominations_ceremoniesinteger

    Wins and all nominations across the ceremonies in ceremonies.

  • summary_kinorium_rustring | null

    Kinorium’s per-ceremony summary, in Russian.

  • summary_imdb_enstring | null

    IMDb’s summary: “Won 4 Oscars. 160 wins & 220 nominations total”. A different text, not a translation of Kinorium’s.

  • ceremoniesarray

    Ceremonies by prestige, Oscars first.

    +−Show 9 fields

    • slugstring | null

      Ceremony code: oscar, bafta, golden_globe…

    • ceremony_ru · ceremony_enstring

      Ceremony name.

    • iconstring | null

      Path to the ceremony icon on api.kinodata.space: gold for a win, grey for a nomination.

    • wonboolean

      Whether there is at least one win.

    • wins · nominationsinteger

      Wins and all nominations, including the won ones.

    • yearsarray

      Ceremony years.

    • itemsarray

      Categories: category_ru, category_en, won, year.

• countriesarray

  Production countries: code (ISO 3166-1, lowercase), name_ru, name_en.

• classificationobject

  Age rating and language.

  +−Show 4 fields

  • age_limitinteger | null

    Russian age rating: 0, 6, 12, 16 or 18.

  • mpaastring | null

    US certificate: G, PG, PG-13, R, NC-17 or TV-*.

  • original_languagestring | null

    Original language, ISO 639-1.

  • is_adultboolean

    Adult content.

• seriesobject

  Series data. All null for a movie.

  +−Show 4 fields

  • seasons_total · episodes_totalinteger | null

    Seasons and episodes.

  • start_year · end_yearinteger | null

    Years on air. end_year is null for a running series.

• mediaobject

  Posters, backdrop, trailers and soundtrack. Other stills and videos are in /titles/{type}/{id}/media.

  +−Show 9 fields

  • poster_url_ru · poster_url_enstring | null

    Poster for a Russian and an English storefront. The English one has English lettering; null if there is none.

  • poster_source_ru · poster_source_enstring | null

    Where the poster comes from: kp, tmdb, imdb, kinorium.

  • posters_by_sourceobject

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

  • backdrop_urlstring | null

    A wide still for a background.

  • poster_animatedstring

    Kinorium’s animated poster: an mp4 clip of up to 7 MB. About one popular title in ten has it; when it’s missing, so is the key. Show it in <video autoplay muted loop playsinline> and load it on demand.

  • trailersarray

    Trailers: url and youtube_id, language, runtime_sec, thumbnail_url, preview_url, kind with labels. All videos are in /media.

  • soundtrackobject | null

    Soundtrack album: name and the Apple Music url.

• genresarray

  Genres: slug, name_ru, name_en.

• companiesarray

  Companies: name, slug and the role kind: production, studio, network, special_effects, distributor_theatrical, distributor_online, dubbing.

• akasarray

  Alternative titles: title, regions (country codes), source and language when it is known.

• tagsarray

  Kinorium tags: kind (adjective for mood, keyword, subgenre) with labels, tag_ru, tag_en.

• watcharray

  Where to watch and what to read, by ascending rank: url, host and the site kind with labels: streaming, ratings, official site, encyclopedia… Every kind is in /enums, set site_kinds.

• parentalarray

  Parental guide by category: category, severity (mild, moderate, severe), labels and source.

• credits_toparray

  Directors and the leading cast, ready to display. The full cast is in /titles/{type}/{id}/cast.

  +−Show 12 fields

  • imdb_idstring | null

    IMDb ID.

  • kp_idstring | null

    Kinopoisk ID.

  • tmdb_idstring | null

    TMDB person ID.

  • kinorium_idstring | null

    Kinorium ID.

  • name_ru · name_enstring | null

    Name.

  • photo_urlstring | null

    Photo.

  • roleenum

    Role. Every value is in /enums, set credit_roles.

  • role_label_ru · role_label_enstring

    Role label: «Режиссёр» / «Director».

  • character_ru · character_enstring | null

    The character, for an actor.

• franchiseobject

  Franchise: name, poster_url and size, the number of titles in it. Only titles in a franchise have this block. The franchise’s titles are in /titles/{type}/{id}/relations?relation=related.

• countsobject

  How much there is on the sub-resources: cast, images, videos, facts, faq, quotes, episodes, seasons, relations. Use them to decide what is worth a separate request.

Errors