API » movie.list

movie.list

Результаты поиска фильмов, используя заданные фильтры. Возвращается 10 первых фильмов.

Пример запроса

    http://api.cinemate.cc/movie.list?apikey=APIKEY&year=2010&format=xml

Параметры

apikey ключ разработчика
type тип фильмов. Возможные значения: movie, serial, short
state состояние фильма. Возможные значения: soon, cinema
mode специальный режим отображения лучших фильмов, отсортированных по рейтингу IMDB. Возможные значения: best
year год выпуска фильма или сериала
genre жанр. В качестве значения (используется slug со страницы http://cinemate.cc/movie/genre/, например, "sport")
country отбор по стране (используется slug со страницы http://cinemate.cc/movie/country/, например, "kazakhstan")
order_by критерий сортировки: create_date (по дате добавления на сайт), release_date (по дате выхода в мире), ru_release_date (по дате выхода в России, по умолчанию)
order порядок сортировки параметра order_by: desc (по убыванию, по умолчанию), asc (по возрастанию)
from, to значения среза параметра order_by в формате даты ДД.ММ.ГГГГ. Включительно.
page, per_page страница и количество записей в выборке. По умолчанию 0 и 10 соответственно. per_page не может быть более 25.
format необязательный параметр формата возвращаемых сервером данных: xml (по умолчанию) или json

Пример ответа

    <response>
        <movie>
            <id>43985</id>
            <type>movie</type>
            <title_russian>Криминальная фишка от Генри</title_russian>
            <title_original>Henry's Crime</title_original>
            <title_english/>
            <year>2010</year>
            <poster>
                <small url="http://cinemate.cc/media/images/poster/2010/68675/1298810716.small.jpg"/>
                <medium url="http://cinemate.cc/media/images/poster/2010/68675/1298810716.medium.jpg"/>
                <big url="http://cinemate.cc/media/images/poster/2010/68675/1298810716.big.jpg"/>
            </poster>
            <runtime>108</runtime>
            <imdb rating="7.0" votes="179"/>
            <kinopoisk rating="0.0" votes="0"/>
            <url>http://cinemate.cc/movie/68675/links/</url>
        </movie>
    </response>

Расшифровка ответа

Каждый узел movie представляет собой информацию о фильме следующего формата:

id ID фильма
type Тип
title_russian русскоязычное название фильма
title_original название фильма в оригинале
title_english англоязычное название фильма
year год выхода фильма
poster включает в себя 3 тега со ссылками на постеры разных размеров
runtime длительность фильма в минутах
imdb рейтинг фильма по версии imdb.com со следующими атрибутами:
rating рейтинг фильма по 10-балльной шкале
votes число голосов за фильм
kinopoisk рейтинг фильма по версии kinopoisk.ru со следующими атрибутами:
rating рейтинг фильма по 10-балльной шкале
votes число голосов за фильм
url ссылка на страницу фильма