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 | ссылка на страницу фильма |