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

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

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

Query Params

page

number

≥ 1

Defaults to 1

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

limit

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

array of strings | null

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

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

Response body

object

docs

array of objects

required

docs*

object

number

required

Id фильма с кинопоиска

externalId

object

required

name

string | null

alternativeName

string | null

enName

string | null

names

array of objects

required

names*

object

name

string

language

string | null

type

string | null

type

string

required

typeNumber

number

required

year

number | null

Год премьеры. При поиске по этому полю, можно использовать интервалы 1860-2030

description

string | null

Описание тайтла

shortDescription

string | null

Сокращенное описание

slogan

string | null

Слоган

status

string | null

Статус релиза тайтла. Доступные значения: filming | pre-production | completed | announced | post-production

rating

object

votes

object

movieLength

number | null

Продолжительность фильма

ratingMpaa

string | null

Возрастной рейтинг по MPAA

ageRating

number | null

Возрастной рейтинг

logo

object

poster

object

backdrop

object

videos

object

genres

array of objects

genres

object

name

string

countries

array of objects

countries

object

name

string

persons

array of objects

persons

object

number | null

Id персоны с кинопоиска

photo

string | null

name

string | null

enName

string | null

description

string

required

profession

string

required

enProfession

string

required

reviewInfo

object

seasonsInfo

array of objects

seasonsInfo

object

number

number | null

episodesCount

number | null

budget

object

fees

object

premiere

object

similarMovies

array of objects

similarMovies

object

number | null

rating

object

required

year

number

required

name

string

required

enName

string

required

alternativeName

string

required

type

string

poster

object

required

sequelsAndPrequels

array of objects

sequelsAndPrequels

object

number | null

rating

object

required

year

number

required

name

string

required

enName

string

required

alternativeName

string

required

type

string

poster

object

required

watchability

object

releaseYears

array of objects

releaseYears

object

start

number | null

Год начала

end

number | null

Год окончания

top10

number | null

Позиция тайтла в топ 10. Чтобы найти фильмы участвующие в рейтинге используйте: !null

top250

number | null

Позиция тайтла в топ 250. Чтобы найти фильмы участвующие в рейтинге используйте: !null

ticketsOnSale

boolean | null

Признак того, что тайтл находится в прокате

totalSeriesLength

number | null

Продолжительность всех серий

seriesLength

number | null

Средняя продолжительность серии

isSeries

boolean

required

Признак сериала

audience

array of objects | null

audience

object

count

number

required

Количество просмотров в кино

country

string

required

Страна в которой проходил показ

lists

array of strings | null

Список коллекций, в которых находится тайтл.

lists

networks

array of objects

required

networks*

object

items

array of objects

required

items*

object

name

string

required

logo

object

required

updatedAt

date-time

required

createdAt

date-time

required

facts

array of objects

required

facts*

object

value

string

required

type

string

required

spoiler

boolean

required

imagesInfo

object

required

total

number

required

Общее количество результатов

limit

number

required

Количество результатов на странице

page

number

required

Текущая страница

pages

number

required

Сколько страниц всего

200