Rating divergence

GET/v1.3/discover/divergence

Titles that Kinopoisk and IMDb rated differently.

divergence is the Kinopoisk rating minus the IMDb rating. Above zero, Kinopoisk rates it higher: the Turkish series The Last Emperor: Abdul Hamid II is 8.0 there and 5.1 on IMDb. Below zero, IMDb rates it higher: Anne Boleyn is 1.6 on Kinopoisk and 5.6 on IMDb.

By default it takes titles with 10,000 votes on both sites and a gap of at least 1 point, largest gaps first. direction=ru keeps the ones Kinopoisk rates higher, direction=west the ones IMDb rates higher.

Filters, sort and fields work as in the catalog, and total accounts for them. You can sort by the gap in the catalog itself too: /titles?sort=-divergence.

Query parameters

directionenum
ru: higher on Kinopoisk; west: higher on IMDb.
ruwest
Default:
both directions
Example: direction=ru
min_votesinteger
How many votes a title needs on each of the two sites.
Default:
10000
Example: min_votes=100000
min_deltanumber
The smallest gap in points, from 0 to 10.
Default:
1.0
Example: min_delta=2
filters, sort and fields
The catalog’s filters, sorting and field selection, as in Filters and sorting. The gap’s name in fields is divergence.
Default:
largest gaps first
Example: kind=movie&sort=-year
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

directionenum | null
The direction from the request. null means both directions.
itemsarray
Titles: the same card as in the catalog.
Show 25 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.
- divergencenumber
  The Kinopoisk rating minus the IMDb rating.
totalinteger
How many titles match the request, filters included.
limit · offset · has_more
Paging, as in every list.

Errors

status	code	when
400	invalid_request	An unknown `direction`; `min_delta` is not a number from 0 to 10; an unknown filter, `sort` key or `fields` name; a parameter of another endpoint (such as `role` or `relation`); `limit` is not a whole number from 1, or `offset` is below 0; `cursor`, since the feed pages with `offset`.
401	unauthorized	The `X-API-Key` header is missing, or the key is unknown or revoked.
429	rate_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.