v1
latestOpenAPI 3.0.02026-07-141764106.1 KBУниверсальный поиск с фильтрами
Этот метод вернет список фильмов удовлетворяющих вашему запросу. <br> В ответе придут поля указанные в параметре selectFields. Если его не указать, то вернутся только дефолтные поля.
Query parameters
Номер страницы
Количество элементов на странице
Список полей требуемых в ответе из модели
Список полей которые не должны быть null или пусты
Сортировка по полям из модели
Тип сортировки применительно к полям из sortField (пример: "1", "-1")
Поиск по ID KinoPoisk (пример: "666", "555", "!666")
Поиск по IMDB ID (пример: "tt666", "tt555", "!tt666")
Поиск по TMDB ID (пример: 666, 555, !666)
Поиск по id KinoPoisk HD (пример: "48e8d0acb0f62d8585101798eaeceec5", "!48e8d0acb0f62d8585101798eaeceec5")
Поиск по типу фильма (пример: "movie", "tv-series", "!anime")
Поиск по номеру типа фильма (пример: 1, 2, !3). Список типов: 1 (movie), 2 (tv-series), 3 (cartoon), 4 (anime), 5 (animated-series).
Поиск по индикатору сериала (пример: true, false)
Поиск по статусу фильма (пример: "announced", "completed", "!filming")
Поиск по году (пример: 1874, 2050, !2020, 2020-2024)
Поиск по года начала релиза (пример: 1874, 2050, !2020, 2020-2024)
Поиск по года окончания релиза (пример: 1874, 2050, !2020, 2020-2024)
Поиск по рейтингу Кинопоиск (пример: 7, 10, 7.2-10)
Поиск по рейтингу IMDB (пример: 7, 10, 7.2-10)
Поиск по рейтингу TMDB (пример: 7, 10, 7.2-10)
Поиск по рейтингу MPAA (пример: "G", "NC-17", "!R")
Поиск по возрастному рейтингу (пример: 12, !18, 12-18)
Поиск по количеству голосов на KP (пример: 1000-6666666)
Поиск по количеству голосов на IMDB (пример: 1000-6666666)
Поиск по количеству голосов на TMDB (пример: 1000-6666666)
Поиск по количеству голосов кинокритиков (пример: 1000-6666666)
Поиск по количеству голосов кинокритиков из России (пример: 1000-6666666)
Поиск по количеству голосов ожидания на Кинопоиске (пример: 1000-6666666)
Поиск по бюджету фильма (пример: 1000-6666666)
Поиск по количеству аудитории (пример: 1000-6666666)
Поиск по продолжительности фильма (пример: 100-120)
Поиск по всей продолжительности одной серии (пример: 20-60)
Поиск по всей продолжительности сериала (пример: 100-120)
Поиск по жанрам (пример: "драма", "комедия", "!мелодрама", "+ужасы")
Поиск по странам (пример: "США", "Россия", "!Франция" , "+Великобритания")
Поиск по наличию билетов в продаже (пример: true, false)
Поиск по сетям производства фильма (пример: "HBO", "Netflix", "!Amazon")
Поиск по ID персон (пример: 666, 555, !666)
Поиск по профессиям персон (пример: "актер", "режиссер", "!сценарист")
Поиск по английским профессиям персон (пример: "actor", "director", "!writer")
Поиск по сборам в мире (пример: 1000-6666666)
Поиск по сборам в США (пример: 1000-6666666)
Поиск по сборам в России (пример: 1000-6666666)
Поиск по дате премьеры в мире (пример: 01.01.2020, 01.01.2020-31.12.2020)
Поиск по дате премьеры в США (пример: 01.01.2020, 01.01.2020-31.12.2020)
Поиск по дате премьеры в России (пример: 01.01.2020, 01.01.2020-31.12.2020)
Поиск по дате премьеры в стриминговых сервисах (пример: 01.01.2020, 01.01.2020-31.12.2020)
Поиск по дате премьеры в кинотеатрах (пример: 01.01.2020, 01.01.2020-31.12.2020)
Поиск по стране премьеры (пример: "США", "Россия", "!Франция" , "+Великобритания")
Поиск по ID KinoPoisk из списка похожих фильмов (пример: 666, 555, !666)
Поиск по ID KinoPoisk из списка сиквелов и преквелов (пример: 666, 555, !666)
Поиск по доуступным платформам для просмотра (пример: "ivi", "okko", "!megogo")
Поиск по коллекциям из KinoPoisk (пример: "top250", "top-100-indian-movies", "!top-100-movies")
Поиск по дате обновления в базе (пример: 01.01.2020, 01.01.2020-31.12.2020)
Поиск по дате добавления в базу (пример: 01.01.2020, 01.01.2020-31.12.2020)
Response
Example response
{
"docs": [
{
"id": 666,
"externalId": {
"kpHD": "48e8d0acb0f62d8585101798eaeceec5",
"imdb": "tt0232500",
"tmdb": 9799
},
"name": "Человек паук",
"alternativeName": "Spider man",
"enName": "Spider man",
"type": "movie",
"typeNumber": 1,
"year": 2023,
"status": "completed",
"rating": {
"kp": 6.2,
"imdb": 8.4,
"tmdb": 3.2,
"filmCritics": 10,
"russianFilmCritics": 5.1,
"await": 6.1
},
"votes": {
"imdb": 50000,
"tmdb": 10000,
"filmCritics": 10000,
"russianFilmCritics": 4000,
"await": 34000
},
"movieLength": 120,
"ratingMpaa": "pg13",
"videos": {
"trailers": [
{
"url": "https://www.youtube.com/embed/ZsJz2TJAPjw",
"name": "Official Trailer",
"site": "youtube",
"type": "TRAILER"
}
],
"teasers": [
{
"url": "https://www.youtube.com/embed/ZsJz2TJAPjw",
"name": "Official Trailer",
"site": "youtube",
"type": "TRAILER"
}
]
},
"persons": [
{
"id": 6317,
"photo": "https://st.kp.yandex.net/images/actor_iphone/iphone360_6317.jpg",
"name": "Пол Уокер",
"enName": "Paul Walker"
}
],
"budget": {
"value": 207283,
"currency": "€"
},
"fees": {
"world": {
"value": 207283,
"currency": "€"
},
"russia": {
"value": 207283,
"currency": "€"
},
"usa": {
"value": 207283,
"currency": "€"
}
},
"premiere": {
"country": "США",
"world": "2023-02-25T02:44:39.359Z",
"russia": "2023-02-25T02:44:39.359Z",
"cinema": "2023-02-25T02:44:39.359Z"
},
"similarMovies": [
{
"rating": {
"kp": 6.2,
"imdb": 8.4,
"tmdb": 3.2,
"filmCritics": 10,
"russianFilmCritics": 5.1,
"await": 6.1
},
"year": 2021
}
],
"sequelsAndPrequels": [
{
"rating": {
"kp": 6.2,
"imdb": 8.4,
"tmdb": 3.2,
"filmCritics": 10,
"russianFilmCritics": 5.1,
"await": 6.1
},
"year": 2021
}
],
"releaseYears": [
{
"start": 2022,
"end": 2023
}
],
"top10": 1,
"top250": 200,
"ticketsOnSale": true,
"totalSeriesLength": 155,
"seriesLength": 20,
"isSeries": true,
"audience": [
{
"count": 1000,
"country": "Россия"
}
],
"lists": [
"250 лучших сериалов"
],
"networks": [
{
"items": [
{
"name": "Netflix"
}
]
}
]
}
]
}