ApiGet.ru

Неофициальный API для получения информации о фильмах и сериалах Кинопоиска

Конструктор запросов

Выберите метод, заполните параметры — готовая ссылка сформируется автоматически.

https://apiget.ru/API/?method=get-info&key=
Открыть

Поиск и получение данных

get-info key

Полная информация по одному материалу (фильм, сериал и др.)
GET /API/?method=get-info&kinopoisk_id={id}&key={key}
ПараметрТипОписание
kinopoisk_idintID фильма на Кинопоиске*
keystringAPI ключ*
Пример ответа 
{
  "error": 0,
  "message": "Ok",
  "kinopoisk_id": 298,
  "title_ru": "Властелин колец: Братство Кольца",
  "title_en": "The Lord of the Rings: The Fellowship of the Ring",
  "year": 2001,
  "type": "movie",
  "duration": "178 мин.",
  "description": "...",
  "rating": {
    "kinopoisk": {"value": 8.6, "count": 850000},
    "imdb": {"value": 8.8, "count": 1950000}
  },
  "genre": ["фэнтези", "приключения", "драма"],
  "country": ["Новая Зеландия", "США"],
  "actors": [
    {"id": 8214, "name": "Элайджа Вуд"},
    {"id": 8213, "name": "Иэн Маккеллен"},
    {"id": 8215, "name": "Вигго Мортенсен"}
  ],
  "director": [
    {"name": "Питер Джексон", "id": 27977}
  ],
  "scenario": [
    {"name": "Фрэн Уолш", "id": 40545},
    {"name": "Филиппа Бойенс", "id": 40547}
  ],
  "producer": [{"name": "Питер Джексон", "id": 27977}],
  "operator": [{"name": "Эндрю Лесни", "id": 46135}],
  "composer": [{"name": "Говард Шор", "id": 22498}],
  "painter": [{"name": "Грант Мэйджор"}],
  "installation": [{"name": "Джон Гилберт"}],
  "poster_big": "https://...",
  "poster_small": "https://...",
  "similar_materials": [...],
  "stills": [...],
  "facts": [...],
  "fail": [...]
}

list key

Информация по нескольким материалам за один запрос (до 100 ID)
GET /API/?method=list&ids={id1},{id2},{id3}&key={key}
ПараметрТипОписание
idsstringID через запятую (максимум 100)*
keystringAPI ключ*

search key

Поиск по названию с фильтрами (жанр, год, страна, тип)
GET /API/?method=search&query={запрос}&key={key}
ПараметрТипОписание
querystringПоисковый запрос
keystringAPI ключ*
yearintФильтр по году
genrestringФильтр по жанру
countrystringФильтр по стране
typestringФильтр по типу
pageintСтраница (по умолч. 1)
limitintКол-во (1–100, по умолч. 20)
Пример ответа 
{
  "error": 0,
  "message": "Ok",
  "page": 1,
  "limit": 20,
  "has_next": true,
  "results": [
    {
      "kinopoisk_id": 298,
      "title_ru": "Властелин колец: Братство Кольца",
      "title_en": "The Lord of the Rings: The Fellowship of the Ring",
      "year": 2001,
      "type": "movie",
      "rating": {
        "kinopoisk": {"value": 8.6, "count": 850000},
        "imdb": {"value": 8.8, "count": 1950000}
      }
    }
  ]
}

get-random key

Случайные материалы с фильтрацией
GET /API/?method=get-random&key={key}&count=5
ПараметрТипОписание
keystringAPI ключ*
countintКоличество (1–20, по умолч. 5)
genrestringФильтр по жанру
yearintФильтр по году
countrystringФильтр по стране
typestringФильтр по типу

Справочники и статистика

get-count key

Общее количество материалов в базе, распределение по типам
GET /API/?method=get-count&key={key}

get-genres key

Все жанры с количеством материалов
GET /API/?method=get-genres&key={key}

get-countries key

Все страны с количеством материалов
GET /API/?method=get-countries&key={key}

get-years key

Все годы с количеством материалов
GET /API/?method=get-years&key={key}

get-updates key

Недавно обновлённые материалы
GET /API/?method=get-updates&key={key}
ПараметрТипОписание
keystringAPI ключ*
sinceintUnix timestamp начала (по умолч. 7 дней назад)
pageintСтраница
limitintКол-во (1–100, по умолч. 20)

Дополнительные данные

get-episodes key

Эпизоды сериала (сезоны, серии, даты выхода)
GET /API/?method=get-episodes&kinopoisk_id={id}&key={key}
ПараметрТипОписание
kinopoisk_idintID сериала*
keystringAPI ключ*
seasonintФильтр по сезону
Ответ: seasons, total, episodes[] — сезон, номер, название, дата выхода

get-soundtracks key

Саундтреки фильма/сериала (ссылки на Яндекс.Музыку)
GET /API/?method=get-soundtracks&kinopoisk_id={id}&key={key}
ПараметрТипОписание
kinopoisk_idintID материала*
keystringAPI ключ*
Ответ: total, soundtracks[] — тип (album/playlist), yamusic_id, url

get-stills key

Кадры из фильма/сериала
GET /API/?method=get-stills&kinopoisk_id={id}&key={key}
ПараметрТипОписание
kinopoisk_idintID материала*
keystringAPI ключ*
Ответ: total, stills[] — массив URL кадров

get-facts key

Факты и ляпы фильма/сериала
GET /API/?method=get-facts&kinopoisk_id={id}&key={key}&type=all
ПараметрТипОписание
kinopoisk_idintID материала*
keystringAPI ключ*
typestringfacts / bloopers / all (по умолч. all)
Ответ: facts[], facts_total, bloopers[], bloopers_total

get-similar key

Похожие фильмы и сиквелы/приквелы
GET /API/?method=get-similar&kinopoisk_id={id}&key={key}
ПараметрТипОписание
kinopoisk_idintID материала*
keystringAPI ключ*
Ответ: total, similar[] — массив похожих фильмов с рейтингами

get-trailers key

Трейлеры фильма/сериала
GET /API/?method=get-trailers&kinopoisk_id={id}&key={key}
ПараметрТипОписание
kinopoisk_idintID материала*
keystringAPI ключ*
Ответ: total, trailers[] — URL трейлера и превью

Рейтинги

get-top250 key

Топ-250 фильмов по рейтингу КП (50 000+ оценок)
GET /API/?method=get-top250&key={key}
ПараметрТипОписание
keystringAPI ключ*
pageintСтраница (по умолч. 1)
limitintКол-во (1–100, по умолч. 50)

get-top500 key

Топ-500 фильмов по рейтингу КП (20 000+ оценок)
GET /API/?method=get-top500&key={key}
ПараметрТипОписание
keystringAPI ключ*
pageintСтраница (по умолч. 1)
limitintКол-во (1–100, по умолч. 50)

Актёры

get-actor key

Информация об актёре/участнике съёмок с фильмографией
GET /API/?method=get-actor&kinopoisk_id={id}&key={key}
ПараметрТипОписание
kinopoisk_idintID актёра на Кинопоиске*
keystringAPI ключ*
Пример ответа 
{
  "error": 0,
  "message": "Ok",
  "kinopoisk_id": 8215,
  "name": "Иэн Маккеллен",
  "career": "Актер, Продюсер, Сценарист",
  "height": "180",
  "birth": "1939-05-25",
  "birth_place": "Бернли, Ланкашир, Англия, Великобритания",
  "genre": "драма, фэнтези, приключения",
  "total_films": "311",
  "image": "https://avatars.mds.yandex.net/.../orig",
  "films": [
    {
      "kinopoisk_id": 298,
      "title_ru": "Властелин колец: Братство Кольца",
      "title_en": "The Lord of the Rings: The Fellowship of the Ring",
      "year": 2001,
      "type": "movie",
      "rating_kp": 8.6,
      "poster_small": "https://..."
    },
    {
      "kinopoisk_id": 312,
      "title_ru": "Люди Икс",
      "title_en": "X-Men",
      "year": 2000,
      "type": "movie",
      "rating_kp": 7.3,
      "poster_small": "https://..."
    }
  ]
}

search-actor key

Поиск актёров и участников съёмок по имени
GET /API/?method=search-actor&query={name}&key={key}
ПараметрТипОписание
querystringИмя актёра (или часть)*
keystringAPI ключ*
pageintСтраница (по умолч. 1)
limitintКол-во (1–100, по умолч. 20)
Пример ответа 
{
  "error": 0,
  "message": "Ok",
  "page": 1,
  "limit": 20,
  "has_next": false,
  "results": [
    {
      "kinopoisk_id": 8215,
      "name": "Иэн Маккеллен",
      "career": "Актер, Продюсер, Сценарист",
      "height": "180",
      "birth": "1939-05-25",
      "birth_place": "Бернли, Ланкашир, Англия, Великобритания",
      "genre": "драма, фэнтези, приключения",
      "total_films": "311",
      "image": "https://avatars.mds.yandex.net/.../orig"
    }
  ]
}

Аккаунт

Методы аккаунта используют секретный ключ из профиля.

get-list-key secretkey

Список API-ключей пользователя
GET /API/?method=get-list-key&secretkey={secretkey}

get-balance secretkey

Баланс, цена за запрос, доступное количество
GET /API/?method=get-balance&secretkey={secretkey}

get-stats key

Статистика запросов по API-ключу
GET /API/?method=get-stats&key={key}&days=30
ПараметрТипОписание
keystringAPI ключ*
daysintПериод в днях (1–90, по умолч. 30)

Коды ошибок

КодОписание
0Успешный запрос
1Материал не существует
2Материал не существует, данные требуют проверки
4Неверный ключ доступа
10Нет информации по данному ID
16Ошибка формата ID
17Недопустимый GET параметр
18Недостаточно средств
19Превышено количество ID (макс. 100)
20Неверный метод API
22Отсутствует обязательный параметр
24Недопустимый ID
25Неверный секретный ключ
26Секретный ключ не найден