Скрытые жемчужины

GET/v1.3/discover/hidden-gems

Высоко оценённые фильмы и сериалы, о которых знает не так много людей.

Жемчужины — это каталог с пресетом hidden_gems: тот же ответ даёт /titles?preset=hidden_gems. Жемчужина — тайтл, у которого 1 000–50 000 голосов на Кинопоиске и 1 000–25 000 на IMDb: его оценили всерьёз, но знают его немногие. Короткий метр, ТВ-шоу, концерты, стендапы, записи спектаклей (жанр theatre), музыка и документальное кино не попадают.

Идут по rating_weighted — средней оценке Кинопоиска, IMDb и TMDB, взвешенной по числу голосов. По умолчанию наверху много сериалов, среди них азиатские; kind=movie даёт фильмы: «День Доктора», «Кто там поёт», «Марафонцы бегут круг почета», «Красивые деревни красиво горят».

Работает всё, что понимает каталог: фильтры, q, sort, fields и курсор.

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

• фильтры, 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

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

Ошибки