API Reference

Универсальный поиск с фильтрами

get
https://api.kinopoisk.dev/v1.4/movie

Этот метод вернет список фильмов удовлетворяющих вашему запросу.
В ответе придут поля указанные в параметре selectFields. Если его не указать, то вернутся только дефолтные поля.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
number
≥ 1
Defaults to 1

Номер страницы

number
1 to 250
Defaults to 10

Количество элементов на странице

selectFields
array of strings

Список полей требуемых в ответе из модели

selectFields
notNullFields
array of strings

Список полей которые не должны быть null или пусты

notNullFields
sortField
array of strings

Сортировка по полям из модели

sortField
sortType
array of strings

Тип сортировки применительно к полям из sortField (пример: "1", "-1")

sortType
id
array of strings | null

Поиск по ID KinoPoisk (пример: "666", "555", "!666")

id
externalId.imdb
array of strings | null

Поиск по IMDB ID (пример: "tt666", "tt555", "!tt666")

externalId.imdb
externalId.tmdb
array of numbers | null

Поиск по TMDB ID (пример: 666, 555, !666)

externalId.tmdb
externalId.kpHD
array of strings | null

Поиск по id KinoPoisk HD (пример: "48e8d0acb0f62d8585101798eaeceec5", "!48e8d0acb0f62d8585101798eaeceec5")

externalId.kpHD
type
array of strings | null

Поиск по типу фильма (пример: "movie", "tv-series", "!anime")

type
typeNumber
array of strings | null

Поиск по номеру типа фильма (пример: 1, 2, !3). Список типов: 1 (movie), 2 (tv-series), 3 (cartoon), 4 (anime), 5 (animated-series).

typeNumber
isSeries
array of strings | null

Поиск по индикатору сериала (пример: true, false)

isSeries
status
array of strings | null

Поиск по статусу фильма (пример: "announced", "completed", "!filming")

status
year
array of strings | null

Поиск по году (пример: 1874, 2050, !2020, 2020-2024)

year
releaseYears.start
array of strings | null

Поиск по года начала релиза (пример: 1874, 2050, !2020, 2020-2024)

releaseYears.start
releaseYears.end
array of strings | null

Поиск по года окончания релиза (пример: 1874, 2050, !2020, 2020-2024)

releaseYears.end
rating.kp
array of strings | null

Поиск по рейтингу Кинопоиск (пример: 7, 10, 7.2-10)

rating.kp
rating.imdb
array of strings | null

Поиск по рейтингу IMDB (пример: 7, 10, 7.2-10)

rating.imdb
rating.tmdb
array of strings | null

Поиск по рейтингу TMDB (пример: 7, 10, 7.2-10)

rating.tmdb
ratingMpaa
array of strings | null

Поиск по рейтингу MPAA (пример: "G", "NC-17", "!R")

ratingMpaa
ageRating
array of strings | null

Поиск по возрастному рейтингу (пример: 12, !18, 12-18)

ageRating
votes.kp
array of strings | null

Поиск по количеству голосов на KP (пример: 1000-6666666)

votes.kp
votes.imdb
array of strings | null

Поиск по количеству голосов на IMDB (пример: 1000-6666666)

votes.imdb
votes.tmdb
array of strings | null

Поиск по количеству голосов на TMDB (пример: 1000-6666666)

votes.tmdb
votes.filmCritics
array of strings | null

Поиск по количеству голосов кинокритиков (пример: 1000-6666666)

votes.filmCritics
votes.russianFilmCritics
array of strings | null

Поиск по количеству голосов кинокритиков из России (пример: 1000-6666666)

votes.russianFilmCritics
votes.await
array of strings | null

Поиск по количеству голосов ожидания на Кинопоиске (пример: 1000-6666666)

votes.await
budget.value
array of strings | null

Поиск по бюджету фильма (пример: 1000-6666666)

budget.value
audience.count
array of strings | null

Поиск по количеству аудитории (пример: 1000-6666666)

audience.count
movieLength
array of strings | null

Поиск по продолжительности фильма (пример: 100-120)

movieLength
seriesLength
array of strings | null

Поиск по всей продолжительности одной серии (пример: 20-60)

seriesLength
totalSeriesLength
array of strings | null

Поиск по всей продолжительности сериала (пример: 100-120)

totalSeriesLength
genres.name
array of strings | null

Поиск по жанрам (пример: "драма", "комедия", "!мелодрама", "+ужасы")

genres.name
countries.name
array of strings | null

Поиск по странам (пример: "США", "Россия", "!Франция" , "+Великобритания")

countries.name
ticketsOnSale
array of strings | null

Поиск по наличию билетов в продаже (пример: true, false)

ticketsOnSale
networks.items.name
array of strings | null

Поиск по сетям производства фильма (пример: "HBO", "Netflix", "!Amazon")

networks.items.name
persons.id
array of strings | null

Поиск по ID персон (пример: 666, 555, !666)

persons.id
persons.profession
array of strings | null

Поиск по профессиям персон (пример: "актер", "режиссер", "!сценарист")

persons.profession
persons.enProfession
array of strings | null

Поиск по английским профессиям персон (пример: "actor", "director", "!writer")

persons.enProfession
fees.world
array of strings | null

Поиск по сборам в мире (пример: 1000-6666666)

fees.world
fees.usa
array of strings | null

Поиск по сборам в США (пример: 1000-6666666)

fees.usa
fees.russia
array of strings | null

Поиск по сборам в России (пример: 1000-6666666)

fees.russia
premiere.world
array of strings | null

Поиск по дате премьеры в мире (пример: 01.01.2020, 01.01.2020-31.12.2020)

premiere.world
premiere.usa
array of strings | null

Поиск по дате премьеры в США (пример: 01.01.2020, 01.01.2020-31.12.2020)

premiere.usa
premiere.russia
array of strings | null

Поиск по дате премьеры в России (пример: 01.01.2020, 01.01.2020-31.12.2020)

premiere.russia
premiere.digital
array of strings | null

Поиск по дате премьеры в стриминговых сервисах (пример: 01.01.2020, 01.01.2020-31.12.2020)

premiere.digital
premiere.cinema
array of strings | null

Поиск по дате премьеры в кинотеатрах (пример: 01.01.2020, 01.01.2020-31.12.2020)

premiere.cinema
premiere.country
array of strings | null

Поиск по стране премьеры (пример: "США", "Россия", "!Франция" , "+Великобритания")

premiere.country
similarMovies.id
array of strings | null

Поиск по ID KinoPoisk из списка похожих фильмов (пример: 666, 555, !666)

similarMovies.id
sequelsAndPrequels.id
array of strings | null

Поиск по ID KinoPoisk из списка сиквелов и преквелов (пример: 666, 555, !666)

sequelsAndPrequels.id
watchability.items.name
array of strings | null

Поиск по доуступным платформам для просмотра (пример: "ivi", "okko", "!megogo")

watchability.items.name
lists
array of strings | null

Поиск по коллекциям из KinoPoisk (пример: "top250", "top-100-indian-movies", "!top-100-movies")

lists
updatedAt
array of strings | null

Поиск по дате обновления в базе (пример: 01.01.2020, 01.01.2020-31.12.2020)

updatedAt
createdAt
array of strings | null

Поиск по дате добавления в базу (пример: 01.01.2020, 01.01.2020-31.12.2020)

createdAt
Response

Updated over 2 years ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated over 2 years ago