Топ

GET/v1.3/charts/top

Лучшие по оценке фильмы и сериалы с порогом голосов — для рейтингов и «топ-100».

Топ — это каталог с пресетом top: тот же ответ даёт /titles?preset=top. В него попадают тайтлы, у которых на IMDb не меньше 100 000 голосов, есть оценка Кинопоиска и постер, и идут они по оценке IMDb. Порог отсекает оценки, которые поставили несколько человек.

Работает всё, что понимает каталог: фильтры, q, sort, fields и курсор. order=asc переворачивает топ: первой идёт «Белоснежка» 2025 года с 2.2. Порог можно сдвинуть votes_imdb.gte. Это нужно для кино, которое мало смотрят за рубежом: «Бригада» и «Остров» набирают на IMDb 10–20 тысяч голосов, и с порогом 100 000 их в топе нет. country=ru&votes_imdb.gte=10000 даёт «Бригаду», «Дурака», «Возвращение» и «Остров».

Параметры запроса

• фильтры, q и sort

  Всё, что понимает каталог: фильтры, поиск q, sort со знаком, fields и курсор cursor. Подробно — в Фильтры и сортировка.

  Пример: kind=movie&country=fr
• langru | en

  Оставить в ответе один язык. Без него текстовые поля приходят парами _ru и _en. Подробнее — Языки ответа.

  Пример: lang=en
• limitinteger

  Сколько тайтлов вернуть, целое от 1 до 50.

  По умолчанию:

  50

  Пример: limit=20
• offsetinteger

  Сколько тайтлов пропустить, целое от 0.

  По умолчанию:

  0

Поля ответа

• itemsarray

  Тайтлы — та же карточка, что в каталоге.

  +−Показать 24 поля

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

    ID тайтла в каталогах. Приходят всегда, даже с fields.

  • title_ru · title_en · title_originalstring | null

    Названия: на русском, на английском и на языке оригинала.

  • yearinteger | null

    Год выхода.

  • release_datestring | null

    Первая дата выхода, YYYY-MM-DD.

  • kindenum

    Вид тайтла: movie, series, mini_series, tv_show, anime, cartoon, short.

  • poster_url_ru · poster_url_enstring | null

    Постер для русской и английской витрины.

  • posters_by_sourceobject

    Постер каждого источника: kp, tmdb, imdb, kinorium.

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

    Оценки Кинопоиска, TMDB, IMDb, Кинориума и Letterboxd, шкала 0–10.

  • votes_kp · votes_tmdb · votes_imdbinteger | null

    Голоса Кинопоиска, TMDB и IMDb.

  • countriesarray

    Страны: code, name_ru, name_en.

  • genresarray

    Жанры: slug, name_ru, name_en.

• totalnull

  Как в каталоге: общее число не считается. Листайте по has_more или курсором.

• limit · offset · has_more · next_cursor

  Пагинация — как в каталоге.

Ошибки