Перейти к содержимому
Разделы: Расхождения оценок

Подборки и витрины

Расхождения оценок

GET/v1.3/discover/divergence

Тайтлы, которые на Кинопоиске и IMDb оценили по-разному.

divergence — оценка Кинопоиска минус оценка IMDb. Больше нуля — Кинопоиск ставит выше: турецкий сериал «Последний император» там 8.0, на IMDb 5.1. Меньше нуля — выше IMDb: «Анна Болейн» на Кинопоиске 1.6, на IMDb 5.6.

По умолчанию берутся тайтлы с 10 000 голосов на обоих сайтах и расхождением от 1 балла, сильные расхождения — первыми. direction=ru оставляет те, что выше на Кинопоиске, direction=west — выше на IMDb.

Фильтры, sort и fields — как в каталоге, и total их учитывает. Отсортировать по расхождению можно и в самом каталоге: /titles?sort=-divergence.

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

  • directionenum

    ru — выше на Кинопоиске, west — выше на IMDb.

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

    оба направления

    Пример: direction=ru
  • min_votesinteger

    Сколько голосов нужно на каждом из двух сайтов.

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

    10000

    Пример: min_votes=100000
  • min_deltanumber

    Наименьшее расхождение в баллах, от 0 до 10.

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

    1.0

    Пример: min_delta=2
  • фильтры, sort и fields

    Фильтры, сортировка и выбор полей каталога, как в Фильтры и сортировка. Поле расхождения в fields — divergence.

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

    сильные расхождения первыми

    Пример: kind=movie&sort=-year
  • langru | en

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

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

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

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

    50

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

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

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

    0

Поля ответа

  • directionenum | null

    direction из запроса. null — оба направления.

  • itemsarray

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

    Показать 25 полей
    • 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.

    • divergencenumber

      Оценка Кинопоиска минус оценка IMDb.

  • totalinteger

    Сколько тайтлов подходит под запрос, с фильтрами.

  • limit · offset · has_more

    Пагинация — как в любом списке.

Ошибки

статускодкогда
400invalid_request

Неизвестный direction; min_delta не число от 0 до 10; неизвестный фильтр, ключ sort или поле в fields; параметр другого эндпоинта (например, role или relation); limit не целое от 1 или offset меньше 0; cursor — витрина листается offset.

401unauthorized

Нет заголовка X-API-Key, ключ неизвестен или отозван.

429rate_limited

Исчерпан предел в секунду или квота на сутки.

Все коды и что с ними делать — на странице Ошибки.

Esc

Загружаем оглавление…

    ↑ ↓ выбратьEnter открытьEsc закрыть