Hidden gems

GET/v1.3/discover/hidden-gems

Highly rated movies and series not that many people know about.

Gems are the catalog with the hidden_gems preset: /titles?preset=hidden_gems gives the same response. A gem has 1,000–50,000 Kinopoisk votes and 1,000–25,000 IMDb votes: people rated it seriously, but few know it. Shorts, TV shows, concerts, stand-up, stage recordings (the theatre genre), music and documentaries are left out.

Gems go by rating_weighted: the average of the Kinopoisk, IMDb and TMDB ratings, weighted by vote count. By default the top holds many series, Asian ones among them; kind=movie gives films: The Day of the Doctor, Who’s Singin’ Over There?, The Marathon Family, Pretty Village, Pretty Flame.

Everything the catalog understands works here: filters, q, sort, fields and the cursor.

Query parameters

• filters, q and sort

  Everything the catalog understands: filters, the q search, sort with a sign, fields and the cursor. Details in Filters and sorting.

  Example: kind=movie&country=fr
• 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 titles to return, a whole number from 1 to 50.

  Default:

  50

  Example: limit=20
• offsetinteger

  How many titles to skip, a whole number from 0.

  Default:

  0

Response fields

• itemsarray

  Titles: the same card as in the catalog.

  +−Show 24 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.

• totalnull

  As in the catalog: the total isn’t counted. Page by has_more or with the cursor.

• limit · offset · has_more · next_cursor

  Paging, as in the catalog.

Errors