KinoPlayer.top

API предназначено для удобного получения любой информации из нашей базы. Использовать API можно для обновления вашего сайта, для создания специализированного сервиса или создать автонаполняемый сайт с фильмами онлайн и т. д.

Для того, чтобы получить информацию о фильме, сериале, аниме, аниме-сериале или tv-шоу требуется направить запрос на URL https://kinoplayer.top/index.php?do=api с GET параметрами. Обязательно указание вашего API токена, который можно найти в настройках профиля. Все данные возвращаются в формате json. API поддерживает запросы как по http, так и по https протоколу и принимает параметры kinopoisk_id (получения конкретного материала) или list (получение всех материалов) вмести с параметром page.

Пример использования параметра kinopoisk_id:

https://kinoplayer.top/index.php?do=api&token=yourtoken&kinopoisk_id=444

Где token - ваш API токен, а kinopoisk_id это числовой идентификатор кино на сайте kinopoisk.ru, который можно посмотреть, например в ссылке https://www.kinopoisk.ru/film/444/ на нужный фильм.

Если запрос успешен, то вернется подобный ответ:

{
    "status": "success",
    "messages": "Данные успешно получены",
    "total": 1,
    "total_page": 0,
    "prev_page": 0,
    "next_page": 0,
    "results": {
        "0": {
            "date": "2022-01-30 14:58:13",
            "kp_id": 444,
            "imdb_id": "tt0103064",
            "title_ru": "Терминатор 2: Судный день",
            "title_en": "Terminator 2: Judgment Day",
            "year": 1991,
            "poster": "\/\/kinopoiskapiunofficial.tech\/images\/posters\/kp\/444.jpg",
            "country": "США,Франция",
            "genre": "блокбастер,боевик,триллер,фантастика",
            "actors": "Арнольд Шварценеггер,Линда Хэмилтон,Эдвард Ферлонг,Роберт Патрик,Эрл Боэн,Джо Мортон,С. Ипейта Меркерсон,Кастуло Герра,Дэнни Кукси,Дженетт Голдстин",
            "directors": "Джеймс Кэмерон",
            "producers": "Стефани Остин,Джеймс Кэмерон,Гейл Энн Хёрд",
            "writers": "Джеймс Кэмерон,Уильям Уишер мл.",
            "composers": "Брэд Фидель",
            "editors": "Конрад Бафф IV,Доди Дорн,Марк Голдблатт",
            "designers": "Джозеф С. Немец III,Джозеф П. Лаки,Марлен Стюарт",
            "operators": "Адам Гринберг",
            "premiere": "1991-07-01",
            "age_restrictions": 18,
            "description": "Прошло более десяти лет с тех пор, как киборг-терминатор из 2029 года пытался уничтожить Сару Коннор - женщину, чей будущий сын выиграет войну человечества против машин.\r\n\r\nТеперь у Сары родился сын Джон и время, когда он поведёт за собой выживших людей на борьбу с машинами, неумолимо приближается. Именно в этот момент из постапокалиптического будущего прибывает новый терминатор - практически неуязвимый и способный принимать любое обличье. Цель нового терминатора уже не Сара, а уничтожение молодого Джона Коннора.\r\n\r\nОднако шансы Джона на спасение существенно повышаются, когда на помощь приходит перепрограммированный сопротивлением терминатор предыдущего поколения. Оба киборга вступают в смертельный бой, от исхода которого зависит судьба человечества."
        }
    },
    "all_genres": {
        "0": "аниме",
        "1": "артхаус",
        "2": "биография",
        "3": "блокбастер",
        "4": "боевик",
        "5": "вестерн",
        "6": "военный",
        "7": "детектив",
        "8": "детский",
        "9": "для взрослых",
        "10": "документальный",
        "11": "драма",
        "12": "игра",
        "13": "исторический",
        "14": "комедия",
        "15": "короткометражный",
        "16": "криминал",
        "17": "мелодрама",
        "18": "мистический",
        "19": "музыка",
        "20": "мультфильм",
        "21": "мюзикл",
        "22": "новости",
        "23": "полнометражный",
        "24": "приключения",
        "25": "путешествия",
        "26": "развлекательный",
        "27": "реальное тв",
        "28": "семейный",
        "29": "сериал",
        "30": "спорт",
        "31": "тв-шоу",
        "32": "триллер",
        "33": "ужасы",
        "34": "фантастика",
        "35": "фильм нуар",
        "36": "фэнтези",
        "37": "школа",
        "38": "экшн",
        "39": "эротика"
    }
}

Пример использования параметра list:

https://kinoplayer.top/index.php?do=api&token=yourtoken&list&page=1

Где token - ваш API токен, а параметр list указывает на то, что вам нужно получить весь материал с базы данных. Обратите внимание, что данный метод поддерживает постраничную навигацию параметром page, который принимает значения номера страницы. По умолчанию на одной странице будет выведено 50 результатов, сортировка по дате добавления в порядке убывания.

Если запрос успешен, то вернется подобный ответ:

{
    "status": "success",
    "messages": "Данные успешно получены",
    "total": 57000,
    "total_page": 2850,
    "prev_page": 0,
    "next_page": 2,
    "results": {
        "0": {
            "date": "2022-01-30 15:40:08",
            "kp_id": 409424,
            "imdb_id": "tt1160419",
            "title_ru": "Дюна",
            "title_en": "Dune",
            "year": 2021,
            "poster": "\/\/st.kp.yandex.net\/images\/film_iphone\/iphone360_409424.jpg",
            "country": "США,Канада,Венгрия",
            "genre": "боевик,драма,приключения,фантастика",
            "actors": "Тимоти Шаламе,Ребекка Фергюсон,Оскар Айзек,Джош Бролин,Джейсон Момоа,Зендея,Стеллан Скарсгард,Хавьер Бардем,Дэйв Батиста,Шарлотта Рэмплинг",
            "directors": "Дени Вильнёв",
            "producers": "Дени Вильнёв,Мэри Пэрент,Кейл Бойтер",
            "writers": "Джон Спэйтс,Дени Вильнёв,Эрик Рот",
            "composers": "Ханс Циммер",
            "editors": "Джо Уокер",
            "designers": "Патрис Верметт,Том Браун,Дэвид Доран",
            "operators": "Грег Фрейзер",
            "premiere": "2021-09-03",
            "age_restrictions": 12,
            "description": "Наследник знаменитого дома Атрейдесов Пол отправляется вместе с семьей на одну из самых опасных планет во Вселенной — Арракис. Здесь нет ничего, кроме песка, палящего солнца, гигантских чудовищ и основной причины межгалактических конфликтов — невероятно ценного ресурса, который называется меланж. В результате захвата власти Пол вынужден бежать и скрываться, и это становится началом его эпического путешествия. Враждебный мир Арракиса приготовил для него множество тяжелых испытаний, но только тот, кто готов взглянуть в глаза своему страху, достоин стать избранным."
        },
        "1": {
            "date": "2022-01-30 15:39:47",
            "kp_id": 796660,
            "imdb_id": "tt3032476",
            "title_ru": "Лучше звоните Солу",
            "title_en": "Better Call Saul",
            "year": 2015,
            "poster": "\/\/st.kp.yandex.net\/images\/film_iphone\/iphone360_796660.jpg",
            "country": "США",
            "genre": "драма,комедия,криминал,сериал",
            "actors": "Боб Оденкёрк,Джонатан Бэнкс,Ри Сихорн,Патрик Фабиан,Майкл Мэндо,Майкл МакКин,Джанкарло Эспозито,Марк Марголис,Керри Кондон,Кара Пифко",
            "directors": "Винс Гиллиган,Адам Бернштейн,Томас Шнауз",
            "producers": "Мелисса Бернштейн,Винс Гиллиган,Питер Гулд",
            "writers": "Гордон Смит,Heather Marion,Энн Черкис",
            "composers": "Дэйв Портер,Николя Молляр",
            "editors": "Скип Макдональд,Келли Диксон,Крис МакКалеб",
            "designers": "Тони Фаннинг,Майкл Новотны,Джуди Ри",
            "operators": "Маршалл Адамс,Артур Альберт,Paul Donachie",
            "premiere": "2015-02-08",
            "age_restrictions": 16,
            "description": "История об испытаниях и невзгодах, которые приходится преодолеть Солу Гудману, адвокату по уголовным делам, в тот период, когда он пытается открыть свою собственную адвокатскую контору в Альбукерке, штат Нью-Мексико."
        },
        "2": {
            "date": "2022-01-30 15:39:13",
            "kp_id": 1090027,
            "imdb_id": "tt7552686",
            "title_ru": "Та, которой не было",
            "title_en": "Celle que vous croyez",
            "year": 2019,
            "poster": "\/\/st.kp.yandex.net\/images\/film_iphone\/iphone360_1090027.jpg",
            "country": "Франция,Бельгия",
            "genre": "драма,мелодрама",
            "actors": "Жюльет Бинош,Николь Гарсия,Франсуа Сивиль,Мари-Анж Каста,Гийом Гуи,Шарль Берлинг,Жуль Уплен,Жюль Гозлен,Френсис Леплей,Pierre Giraud",
            "directors": "Сэфи Неббу",
            "producers": "Мишель Сен-Жан",
            "writers": "Сэфи Неббу,Джули Пейр,Камилла Лоранс",
            "composers": "Ибрахим Маалуф",
            "editors": "Стефани Перейра",
            "designers": "Сириль Гомез-Матьё,Александра Чарльз",
            "operators": "Жиль Порте",
            "premiere": "2019-02-10",
            "age_restrictions": 16,
            "description": "Клэр, 50-летняя разведённая учительница, создаёт поддельный профиль 24-летней девушки в Facebook, используя чужие фотографии из интернета. Она делает это для того, чтобы шпионить за своим молодым любовником. Но он отклоняет запросы в друзья от людей, которых не знает лично. Чтобы все-таки добраться до него, Клэр посылает запрос его лучшему другу, и он его принимает. Пара начинает обмениваться сообщениями, и их поддельная дружба стремительно превращается в фальшивую любовь."
        },
        "3": {"...":"..."},
      

        "44": {
            "date": "2022-01-30 15:02:53",
            "kp_id": 716587,
            "imdb_id": "tt2442560",
            "title_ru": "Острые козырьки",
            "title_en": "Peaky Blinders",
            "year": 2013,
            "poster": "\/\/st.kp.yandex.net\/images\/film_iphone\/iphone360_716587.jpg",
            "country": "Великобритания",
            "genre": "драма,криминал,сериал",
            "actors": "Киллиан Мёрфи,Хелен Маккрори,Пол Андерсон,Софи Рандл,Нед Деннехи,Джо Коул,Йен Пек,Финн Коул,Гарри Киртон,Пакки Ли",
            "directors": "Колм МакКарти,Тим Милантс,Дэвид Кэффри",
            "producers": "Кэрин Мэндабах,Джули Бринкман,Джэми Глазенбрук",
            "writers": "Стивен Найт,Тоби Финлэй,Стивен Расселл",
            "composers": "Мартин Фиппс,Пол Хартнолл,Пи Джей Харви",
            "editors": "Марк Дэвис,Пол Найт,Селия Хэйнинг",
            "designers": "Грант Монтгомери,Ричард Буллок,Стефен Дэйли",
            "operators": "Джордж Стил,Саймон Дэннис,Лори Роуз",
            "premiere": "2013-09-12",
            "age_restrictions": 16,
            "description": "Британский сериал о криминальном мире Бирмингема 20-х годов прошлого века, в котором многолюдная семья Шелби стала одной из самых жестоких и влиятельных гангстерских банд послевоенного времени. Фирменным знаком группировки, промышлявшей грабежами и азартными играми, стали зашитые в козырьки лезвия."
        },
        "45": {
            "date": "2022-01-30 15:02:39",
            "kp_id": 4697408,
            "imdb_id": "tt15831226",
            "title_ru": "Том и Джерри: Бравые ковбои!",
            "title_en": "Tom and Jerry: Cowboy Up!",
            "year": 2022,
            "poster": "\/\/st.kp.yandex.net\/images\/film_iphone\/iphone360_4697408.jpg",
            "country": "США",
            "genre": "вестерн,комедия,мультфильм,приключения,семейный",
            "actors": "Джордж Эклс,Шон Бургос,Тревор Дивэлл,Крис Эджерли,Джорджина Кордова,Джастин Майкл,Исаак Робинсон-Смит,Кейтлин Роброк,Кэт Суси,Стефен Стэнтон",
            "directors": "Даррел Ван Ситтерс",
            "producers": "Даррел Ван Ситтерс,Сэм Реджистер",
            "writers": "William Waldner,Уилл Финн",
            "composers": "Вивек Маддала",
            "editors": "",
            "designers": "",
            "operators": "",
            "premiere": "2022-01-25",
            "age_restrictions": "",
            "description": "Том и Джерри отправляются на Дикий Запад, где им предстоит помочь новым друзьям спасти ранчо от коварного землевладельца."
        },
        "46": {
            "date": "2022-01-30 15:02:35",
            "kp_id": 4420223,
            "imdb_id": "tt11712058",
            "title_ru": "Мэр Кингстауна",
            "title_en": "Mayor of Kingstown",
            "year": 2021,
            "poster": "\/\/st.kp.yandex.net\/images\/film_iphone\/iphone360_4420223.jpg",
            "country": "США,Канада",
            "genre": "драма,криминал,сериал,триллер",
            "actors": "Дайэнн Уист,Джереми Реннер,Кайл Чандлер,Дерек Уэбстер,Хью Диллон,Тейлор Хэндли,Emma Laird,Тоби Бамтефа,Хамиш Аллан-Хэдли,Эйдан Гиллен",
            "directors": "Бен Ричардсон,Гай Ферленд,Кларк Джонсон",
            "producers": "Майкл Фридман,Антуан Фукуа,Алекс Джордан",
            "writers": "Хью Диллон,Тейлор Шеридан",
            "composers": "",
            "editors": "Чад Галстер,Тим Бартлетт",
            "designers": "Шелли Мэнселл,Мэри Керклэнд",
            "operators": "Майя Банкович,Стюарт Кэмпбелл",
            "premiere": "2021-11-14",
            "age_restrictions": "",
            "description": "Семья Макласки, которая живет в маленьком мичиганском городке Кингстаун, выступает неофициальными посредниками между полицией, преступниками, заключенными, тюремными охранниками и политиками. Макласки хотят сохранить нейтралитет, но есть и те, кому не нравится тот факт, что одна семья имеет настолько большой контроль над тем, как обстоят дела в Кингстауне."
        },
        "47": {
            "date": "2022-01-30 15:01:13",
            "kp_id": 17468,
            "imdb_id": "tt0072067",
            "title_ru": "Отряд насилия",
            "title_en": "Act of Vengeance",
            "year": 1974,
            "poster": "\/\/st.kp.yandex.net\/images\/film_iphone\/iphone360_17468.jpg",
            "country": "США",
            "genre": "драма,криминал,триллер,ужасы",
            "actors": "Джо Энн Харрис,Питер Браун,Дженнифер Ли,Лиза Мур,Конни Стриклэнд,Патриция Эстрин,Лада Эдмунд мл.,Тони Янг,Стив Кэнэли,Росс Эллиотт",
            "directors": "Боб Келиджан",
            "producers": "",
            "writers": "",
            "composers": "",
            "editors": "",
            "designers": "",
            "operators": "",
            "premiere": "",
            "age_restrictions": 18,
            "description": "Подвергшаяся изнасилованию женщина собирает компанию подруг по несчастью, и вместе они образовывают отряд по борьбе с насильниками."
        },
        "48": {
            "date": "2022-01-30 15:00:35",
            "kp_id": 1073564,
            "imdb_id": "tt7310440",
            "title_ru": "Руководство для серийного убийцы",
            "title_en": "A Serial Killer's Guide to Life",
            "year": 2019,
            "poster": "\/\/st.kp.yandex.net\/images\/film_iphone\/iphone360_1073564.jpg",
            "country": "Великобритания",
            "genre": "комедия,криминал,приключения,ужасы",
            "actors": "Katie Brayben,Поппи Роу,Бен Ллойд-Хьюз,Сара Болл,Адетомива Едун,Шинед Мэтьюз,Сиан Клиффорд,Фиона Глэскотт,Овайн Риз Дейвис,Керис Льюис",
            "directors": "Статен Элиот",
            "producers": "Джиллз Алдерсон,Поппи Роу,Чарити Уэйкфилд",
            "writers": "Статен Элиот",
            "composers": "Laurence Love Greed",
            "editors": "Статен Элиот,Поппи Роу",
            "designers": "Маделайне Лич,Elliot Selfe,Camille Adomakoh",
            "operators": "Джеймс Лэйтон",
            "premiere": "2020-01-13",
            "age_restrictions": "",
            "description": "Лу Фарнт — тридцатилетняя наркоманка, которая хочет сбежать от своей чрезмерно контролирующей матери и захолустного приморского города, где она выросла. Поэтому, когда странный и поразительно уверенный в себе инструктор по персональному росту Вэл неожиданно появляется и приглашает ее принять участие в альтернативной терапии, Лу находит прекрасную возможность попытаться стать лучше и сбежать прочь. К сожалению для Лу, Вэл серийный убийца."
        },
        "49": {
            "date": "2022-01-30 15:00:32",
            "kp_id": 1159922,
            "imdb_id": "tt5607976",
            "title_ru": "Темные начала",
            "title_en": "His Dark Materials",
            "year": 2019,
            "poster": "\/\/st.kp.yandex.net\/images\/film_iphone\/iphone360_1159922.jpg",
            "country": "Великобритания,США",
            "genre": "драма,приключения,семейный,сериал,фэнтези",
            "actors": "Дафни Кин,Джеймс МакЭвой,Рут Уилсон,Кларк Питерс,Иэн Гелдер,Уилл Кин,Эрион Бакаре,Энн-Мэри Дафф,Кит Коннор,Арчи Барнс",
            "directors": "Джейми Чайлдс,Уильям МакГрегор,Отто Батхёрст",
            "producers": "Кэролин Блэквуд,Джоэль Коллинз,Тоби Эммерих",
            "writers": "Джек Торн,Франческа Гардинер,Лидия Адетуньи",
            "composers": "Лорн Бэлф",
            "editors": "Дэвид Фишер,Стивен Харен,Найвен Хоуи",
            "designers": "Джоэль Коллинз,Клаудио Кампана,Джон Хоршэм",
            "operators": "Дэвид Хиггс,Джоэль Дэвлин,Джастин Браун",
            "premiere": "2019-11-03",
            "age_restrictions": 16,
            "description": "Лира Белаква живёт в мире, где существуют ведьмы и бронированные медведи, а у людей есть деймоны — существа, составляющие неотъемлемую часть их личностей. Опекун девочки, исследователь лорд Азриэл, находит способ передвигаться между параллельными землями, благодаря чему Лира знакомится с мальчиком Уиллом, который живёт в мире, лишённом магии."
        }
    },
    "all_genres": {
        "0": "аниме",
        "1": "артхаус",
        "2": "биография",
        "3": "блокбастер",
        "4": "боевик",
        "5": "вестерн",
        "6": "военный",
        "7": "детектив",
        "8": "детский",
        "9": "для взрослых",
        "10": "документальный",
        "11": "драма",
        "12": "игра",
        "13": "исторический",
        "14": "комедия",
        "15": "короткометражный",
        "16": "криминал",
        "17": "мелодрама",
        "18": "мистический",
        "19": "музыка",
        "20": "мультфильм",
        "21": "мюзикл",
        "22": "новости",
        "23": "полнометражный",
        "24": "приключения",
        "25": "путешествия",
        "26": "развлекательный",
        "27": "реальное тв",
        "28": "семейный",
        "29": "сериал",
        "30": "спорт",
        "31": "тв-шоу",
        "32": "триллер",
        "33": "ужасы",
        "34": "фантастика",
        "35": "фильм нуар",
        "36": "фэнтези",
        "37": "школа",
        "38": "экшн",
        "39": "эротика"
    }
}

Стуктура ответа results:

Как узнать тип материал(фильм, сериал, аниме....):

Узнать тип возможно порядком исключения ответа API значения genre.

Например, если жанр "аниме, сериал, боевик" - это аниме-сериал, если в жанре не встречается ключевое слово "сериал", а есть "аниме", то это аниме. Потому же принципу для мультиков, если жанр "мультфильм, сериал, детский" - это мультсериал, если нет слова "сериал",а есть "мультфильм", то это мультфильм. Так далее для определения сериала и фильма, если жанр не имеет значения "мультфильм" и "аниме", а есть значения "сериал", то это сериал, в противном случаи - фильм. Так же нужно добавить проверку на значения "тв-шоу".

Все доступные жанры можно посмотреть в структуре ответа all_genres