Документация API Getmovie DB

Описывается формат http запросов и ответов необходимых разработчику

Для получения кода плеера GetMovie API используется префикс:

HTTP
http://getmovie.cc/api

Все входные данные принимаются через GET параметры.

Формат выходных данных - JSON или XML.

GET запрос отправляется на:

HTTP
http://getmovie.cc/api/videos.json

Передаются следующие параметры:

Параметр Описание Обязательный
kinopoisk_id ID видео с сайта kinopoisk.ru ДА
api_token Уникальный токен-ключ вашего проекта ДА
r Формат выходных данных json или xml ДА

Уникальный токен-ключ можно получить в своем кабинете после регистрации

Пример GET запроса по параметру kinopoisk_id:

HTTP
http://getmovie.cc/api/videos.json?kinopoisk_id=518042&api_token=[your_api_token]&r=json

Ответ приходит в виде JSON или XML с массивом которые удовлетворяют условиям поиска. Из него можно брать первый элемент.

Структура JSON или XML объектов:

Название объекта Описание
id Идентификатор фильма/сериала в базе GetMovie
title_ru Название видео на русском языке согласно базы kinopoisk.ru
title_en Название видео на английском языке согласно базы kinopoisk.ru
year Год выхода
country Страна
description Описание
translator Информация о переводе
actors Актеры в главных ролях
screenwriter Сценарий
director Режиссер
producer Продюсер
operator Оператор
design Художники
editor Монтаж
genre Жанр
composer Композитор
time Продолжительность фильма
type Тип контента: movie / serial
camprip Качество видео. Принимает значение true если это CAMRip и false если видео в HD качестве
kinopoisk_id ID видео в базе kinopoisk.ru
kp_rating Рейтинг КиноПоиск
imdb_rating Рейтинг IMDB
embed_url URL с которого нужно загружать iframe
poster_big Ссылка на большой постер
poster_small Ссылка на маленький постер
trailer Трейлер

В случае пустого объекта идентификатор принимает значение null

Для интеграции на сайт нужно взять этот JSON и сформировать html-код для вставки на сайт вида

HTML
<iframe src="[здесь_значение_параметра_embed_url]" width="607" height="370" frameborder="0" allowfullscreen></iframe>

Значения width и height можете менять на свои, в зависимости от страниц на которые выводите iframe.


Примеры


Пример GET запроса по параметру kinopoisk_id для фильма:

HTTP
http://getmovie.cc/api/videos.json?kinopoisk_id=518042&api_token=037313259a17be837be3bd04a51bf678&r=json 

Пример ответа API для фильма:

JSON
{
 "response":{
    "items":[
      {
        "id": "24790",
        "title_ru": "Агенты А.Н.К.Л.",
        "title_en": "The Man from U.N.C.L.E.",
        "year": "2015",
        "country": "США, Великобритания",
        "description": "Наполеон Соло — агент ЦРУ, на счету которого огромное количество успешно проведенных операций. Он считается одним из лучших секретных агентов во всем мире, и с ним может сравниться только один человек — самый молодой и перспективный агент КГБ, Илья Курякин. Их противостояние переросло в настоящую войну, в которой никто не собирается уступать. Однако обстоятельства складываются так, что непримиримые враги вынуждены стать напарниками. Это происходит после того как спецслужбы двух стран обнаруживают международную преступную организацию, которой удалось создать ядерную бомбу...",
        "translator": "Дубляж",
        "actors": "Генри Кавилл, Арми Хаммер, Алисия Викандер, Элизабет Дебики, Хью Грант, Лука Кальвани, Сильвестр Грот, Джаред Харрис, Кристиан Беркель, Миша Кузнецов",
        "screenwriter": "Гай Ричи, Лайонел Уигрэм, Сэм Рольф",
        "director": "Гай Ричи",
        "producer": "Стив Кларк-Холл, Джон Дэвис, Гай Ричи",
        "operator": "Джон Мэтисон",
        "design": "Оливер Шолль, Дэвид Оллдей, Гай Брэдли",
        "editor": "Джеймс Херберт",
        "genre": "боевик, комедия, приключения",
        "composer": "Дэниэл Пембертон",
        "time": "116 мин. / 01:56",
        "type": "movie",
        "camrip": false,
        "kinopoisk_id": "518042",
        "kp_rating": "7.973",
        "imdb_rating": "7.40",
        "embed_url": "http://getmovie.cc/movies/24790/",
        "poster_big": "http://www.kinopoisk.ru/images/film_big/518042.jpg",
        "poster_small": "http://st.kp.yandex.net/images/film_iphone/iphone360_518042.jpg",
        "trailer": "http://kp.cdn.yandex.net/518042/kinopoisk.ru-Man-from-U_N_C_L_E__-The-248114.mp4",
      }
    ]
  }
}

Пример GET запроса по параметру kinopoisk_id для сериала:

HTTP
http://getmovie.cc/api/videos.json?kinopoisk_id=733493&api_token=037313259a17be837be3bd04a51bf678&r=json

Пример ответа API для сериала:

JSON
{
 "response":{
    "items":[
      {
        "id": "21243",
        "title_ru": "100 / Сотня",
        "title_en": "The 100",
        "year": "2014",
        "country": "США",
        "description": "События в сериале начинают разворачиваться по прошествии девяносто семи лет после того, как всю цивилизацию уничтожила страшная атомная война.Высоко в космосе на орбите Земли летает большой космический корабль, где находятся те, кто выжил после страшной катастрофы. Именно с этого последнего пристанища людей на Землю отправляют космический челнок, на котором находятся сто малолетних преступников...",
        "translator": "Newstudio",
        "actors": "Элайза Тейлор, Мари Авгеропулос, Боб Морли, Генри Йен Кьюсик, Исайя Вашингтон, Пейдж Турко, Рики Уиттл, Ричард Хэрмон, Линдси Морган, Девон Бостик",
        "screenwriter": "Касс Морган, Джейсон Ротенберг, Лина Патель",
        "director": "Дин Уайт, Майрзи Алмас, Эд Фрэйман",
        "producer": "Джа Мэрчент, Дин Уайт, Тим Скэнлэн",
        "operator": "Филип Линзи, Майкл С. Бланделл, Натаниель Гудман",
        "design": "Джеймс Филпотт, Мэттью Баджон, Алисса Кинг",
        "editor": "Хантер М. Вия, Сара Минео, Мэтт Барбер",
        "genre": "фантастика, драма, детекти",
        "composer": "Марк Доэ, Эван Фрэнкфорт, Лиз Фэир",
        "time": "60 мин. / 01:00",
        "type": "serial",
        "camrip": false,
        "kinopoisk_id": "733493",
        "kp_rating": "7.899",
        "imdb_rating": "7.80",
        "embed_url": "http://getmovie.cc/serial/21243/",
        "poster_big": "http://www.kinopoisk.ru/images/film_big/733493.jpg",
        "poster_small": "http://st.kp.yandex.net/images/film_iphone/iphone360_733493.jpg",
        "trailer": "http://kp.cdn.yandex.net/733493/kinopoisk.ru-Hundred-The-185908.mp4",
      },
      {
        "id": "21242",
        "title_ru": "100 / Сотня",
        "title_en": "The 100",
        "year": "2014",
        "country": "США",
        "description": "События в сериале начинают разворачиваться по прошествии девяносто семи лет после того, как всю цивилизацию уничтожила страшная атомная война.Высоко в космосе на орбите Земли летает большой космический корабль, где находятся те, кто выжил после страшной катастрофы. Именно с этого последнего пристанища людей на Землю отправляют космический челнок, на котором находятся сто малолетних преступников...",
        "translator": "BaibaKo",
        "actors": "Элайза Тейлор, Мари Авгеропулос, Боб Морли, Генри Йен Кьюсик, Исайя Вашингтон, Пейдж Турко, Рики Уиттл, Ричард Хэрмон, Линдси Морган, Девон Бостик",
        "screenwriter": "Касс Морган, Джейсон Ротенберг, Лина Патель",
        "director": "Дин Уайт, Майрзи Алмас, Эд Фрэйман",
        "producer": "Джа Мэрчент, Дин Уайт, Тим Скэнлэн",
        "operator": "Филип Линзи, Майкл С. Бланделл, Натаниель Гудман",
        "design": "Джеймс Филпотт, Мэттью Баджон, Алисса Кинг",
        "editor": "Хантер М. Вия, Сара Минео, Мэтт Барбер",
        "genre": "фантастика, драма, детекти",
        "composer": "Марк Доэ, Эван Фрэнкфорт, Лиз Фэир",
        "time": "60 мин. / 01:00",
        "type": "serial",
        "camrip": false,
        "kinopoisk_id": "733493",
        "kp_rating": "7.899",
        "imdb_rating": "7.80",
        "embed_url": "http://getmovie.cc/serial/21242/",
        "poster_big": "http://www.kinopoisk.ru/images/film_big/733493.jpg",
        "poster_small": "http://st.kp.yandex.net/images/film_iphone/iphone360_733493.jpg",
        "trailer": "http://kp.cdn.yandex.net/733493/kinopoisk.ru-Hundred-The-185908.mp4",
      },
      {
        "id": "21241",
        "title_ru": "100 / Сотня",
        "title_en": "The 100",
        "year": "2014",
        "country": "США",
        "description": "События в сериале начинают разворачиваться по прошествии девяносто семи лет после того, как всю цивилизацию уничтожила страшная атомная война.Высоко в космосе на орбите Земли летает большой космический корабль, где находятся те, кто выжил после страшной катастрофы. Именно с этого последнего пристанища людей на Землю отправляют космический челнок, на котором находятся сто малолетних преступников...",
        "translator": "LostFilm",
        "actors": "Элайза Тейлор, Мари Авгеропулос, Боб Морли, Генри Йен Кьюсик, Исайя Вашингтон, Пейдж Турко, Рики Уиттл, Ричард Хэрмон, Линдси Морган, Девон Бостик",
        "screenwriter": "Касс Морган, Джейсон Ротенберг, Лина Патель",
        "director": "Дин Уайт, Майрзи Алмас, Эд Фрэйман",
        "producer": "Джа Мэрчент, Дин Уайт, Тим Скэнлэн",
        "operator": "Филип Линзи, Майкл С. Бланделл, Натаниель Гудман",
        "design": "Джеймс Филпотт, Мэттью Баджон, Алисса Кинг",
        "editor": "Хантер М. Вия, Сара Минео, Мэтт Барбер",
        "genre": "фантастика, драма, детекти",
        "composer": "Марк Доэ, Эван Фрэнкфорт, Лиз Фэир",
        "time": "60 мин. / 01:00",
        "type": "serial",
        "camrip": false,
        "kinopoisk_id": "733493",
        "kp_rating": "7.899",
        "imdb_rating": "7.80",
        "embed_url": "http://getmovie.cc/serial/21241/",
        "poster_big": "http://www.kinopoisk.ru/images/film_big/733493.jpg",
        "poster_small": "http://st.kp.yandex.net/images/film_iphone/iphone360_733493.jpg",
        "trailer": "http://kp.cdn.yandex.net/733493/kinopoisk.ru-Hundred-The-185908.mp4",
      },
      {
        "id": "21240",
        "title_ru": "100 / Сотня",
        "title_en": "The 100",
        "year": "2014",
        "country": "США",
        "description": "События в сериале начинают разворачиваться по прошествии девяносто семи лет после того, как всю цивилизацию уничтожила страшная атомная война.Высоко в космосе на орбите Земли летает большой космический корабль, где находятся те, кто выжил после страшной катастрофы. Именно с этого последнего пристанища людей на Землю отправляют космический челнок, на котором находятся сто малолетних преступников...",
        "translator": "Alexfilm",
        "actors": "Элайза Тейлор, Мари Авгеропулос, Боб Морли, Генри Йен Кьюсик, Исайя Вашингтон, Пейдж Турко, Рики Уиттл, Ричард Хэрмон, Линдси Морган, Девон Бостик",
        "screenwriter": "Касс Морган, Джейсон Ротенберг, Лина Патель",
        "director": "Дин Уайт, Майрзи Алмас, Эд Фрэйман",
        "producer": "Джа Мэрчент, Дин Уайт, Тим Скэнлэн",
        "operator": "Филип Линзи, Майкл С. Бланделл, Натаниель Гудман",
        "design": "Джеймс Филпотт, Мэттью Баджон, Алисса Кинг",
        "editor": "Хантер М. Вия, Сара Минео, Мэтт Барбер",
        "genre": "фантастика, драма, детекти",
        "composer": "Марк Доэ, Эван Фрэнкфорт, Лиз Фэир",
        "time": "60 мин. / 01:00",
        "type": "serial",
        "camrip": false,
        "kinopoisk_id": "733493",
        "kp_rating": "7.899",
        "imdb_rating": "7.80",
        "embed_url": "http://getmovie.cc/serial/21240/",
        "poster_big": "http://www.kinopoisk.ru/images/film_big/733493.jpg",
        "poster_small": "http://st.kp.yandex.net/images/film_iphone/iphone360_733493.jpg",
        "trailer": "http://kp.cdn.yandex.net/733493/kinopoisk.ru-Hundred-The-185908.mp4",
      },
      {
        "id": "21239",
        "title_ru": "100 / Сотня",
        "title_en": "The 100",
        "year": "2014",
        "country": "США",
        "description": "События в сериале начинают разворачиваться по прошествии девяносто семи лет после того, как всю цивилизацию уничтожила страшная атомная война.Высоко в космосе на орбите Земли летает большой космический корабль, где находятся те, кто выжил после страшной катастрофы. Именно с этого последнего пристанища людей на Землю отправляют космический челнок, на котором находятся сто малолетних преступников...",
        "translator": "Субтитры",
        "actors": "Элайза Тейлор, Мари Авгеропулос, Боб Морли, Генри Йен Кьюсик, Исайя Вашингтон, Пейдж Турко, Рики Уиттл, Ричард Хэрмон, Линдси Морган, Девон Бостик",
        "screenwriter": "Касс Морган, Джейсон Ротенберг, Лина Патель",
        "director": "Дин Уайт, Майрзи Алмас, Эд Фрэйман",
        "producer": "Джа Мэрчент, Дин Уайт, Тим Скэнлэн",
        "operator": "Филип Линзи, Майкл С. Бланделл, Натаниель Гудман",
        "design": "Джеймс Филпотт, Мэттью Баджон, Алисса Кинг",
        "editor": "Хантер М. Вия, Сара Минео, Мэтт Барбер",
        "genre": "фантастика, драма, детекти",
        "composer": "Марк Доэ, Эван Фрэнкфорт, Лиз Фэир",
        "time": "60 мин. / 01:00",
        "type": "serial",
        "camrip": false,
        "kinopoisk_id": "733493",
        "kp_rating": "7.899",
        "imdb_rating": "7.80",
        "embed_url": "http://getmovie.cc/serial/21239/",
        "poster_big": "http://www.kinopoisk.ru/images/film_big/733493.jpg",
        "poster_small": "http://st.kp.yandex.net/images/film_iphone/iphone360_733493.jpg",
        "trailer": "http://kp.cdn.yandex.net/733493/kinopoisk.ru-Hundred-The-185908.mp4",
      }	  
    ]
  }
}

Пример HTML кода плеера для фильма, размещенного на сайте:

HTML
<iframe src="http://getmovie.cc/movies/24790/" width="610" height="370" frameborder="0" allowfullscreen></iframe>

Пример HTML кода плеера для сериала, размещенного на сайте:

HTML
<iframe src="http://getmovie.cc/serial/21243/" width="610" height="370" frameborder="0" allowfullscreen></iframe>

General

  • Обновление дизайна сайта
    2016-11-19 19:14:47
  • Разработан парсер API КиноПоиск
    2016-11-10 16:19:24
  • Полностью изменен стиль плеера в отличии от самой первой версии
    2016-11-10 16:19:24