Универсальный поиск с фильтрами (cursor)
Вернёт список фильмов по вашему запросу. В ответе придут поля указанные в selectFields (если не указать — дефолтные поля).
Используется курсорная пагинация: для следующей страницы передайте next из ответа. Листайте, пока hasNext не станет false.
Request
- Base URL: https://api.poiskkino.dev
- URL: https://api.poiskkino.dev/v1.5/movie
- Auth: API key in header X-API-KEY
Query parameters
Список полей требуемых в ответе из модели
Список полей которые не должны быть null или пусты
Поиск по 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)
Поиск по id жанров из справочника /v1.5/dictionary/genres (пример: 6, !7, +10)
Поиск по slug жанров из справочника /v1.5/dictionary/genres (пример: "comedy", "!drama", "+horror")
Поиск по id стран из справочника /v1.5/dictionary/countries (пример: 1, !2, +3)
Поиск по id профессий персон из справочника /v1.5/dictionary/professions (пример: 1, !2)
Количество элементов на странице
Курсор для получения следующей страницы. Берётся из поля next в ответе предыдущего запроса. При первом запросе не передавайте этот параметр.
Курсор для получения предыдущей страницы. Берётся из поля prev в ответе предыдущего запроса.
Поле для сортировки
Тип сортировки (пример: "1", "-1")
Включить подсчёт общего количества документов. Внимание: может значительно замедлить запрос при использовании фильтров на больших коллекциях.
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"
}
]
},
"genres": [
{
"name": "комедия",
"id": 6,
"slug": "comedy"
}
],
"countries": [
{
"name": "США",
"id": 1
}
],
"persons": [
{
"id": 6317,
"photo": "https://st.kp.yandex.net/images/actor_iphone/iphone360_6317.jpg",
"name": "Пол Уокер",
"enName": "Paul Walker",
"profession": "актеры",
"enProfession": "actor",
"professionId": 1
}
],
"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": 2030
}
],
"sequelsAndPrequels": [
{
"rating": {
"kp": 6.2,
"imdb": 8.4,
"tmdb": 3.2,
"filmCritics": 10,
"russianFilmCritics": 5.1,
"await": 6.1
},
"year": 2030
}
],
"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"
}
]
}
}
],
"next": "eyJ2Ijo3LjUsImlkIjoiNTA3ZjFmNzdiY2Y4NmNkNzk5NDM5MDExIn0=",
"prev": "eyJ2Ijo3LjUsImlkIjoiNTA3ZjFmNzdiY2Y4NmNkNzk5NDM5MDExIn0="
}Changes
No recorded changes to this operation across all 1 revision of this API.