API Reference
Start typing to search…

Получить рандомный тайтл из базы

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

Этот метод вернет рандомный тайтл из базы. Вы можете составить фильтр, чтобы получить рандомный тайтл по вашим критериям.

Log in to see full request history
Query Params
notNullFields
array of strings

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

notNullFields
array of strings | null

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

id
array of strings | null

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

externalId.imdb
array of numbers | null

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

externalId.tmdb
array of strings | null

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

externalId.kpHD
array of strings | null

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

type
array of strings | null

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

typeNumber
array of strings | null

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

isSeries
array of strings | null

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

status
array of strings | null

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

year
array of strings | null

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

releaseYears.start
array of strings | null

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

releaseYears.end
array of strings | null

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

rating.kp
array of strings | null

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

rating.imdb
array of strings | null

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

rating.tmdb
array of strings | null

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

ratingMpaa
array of strings | null

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

ageRating
array of strings | null

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

votes.kp
array of strings | null

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

votes.imdb
array of strings | null

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

votes.tmdb
array of strings | null

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

votes.filmCritics
array of strings | null

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

votes.russianFilmCritics
array of strings | null

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

votes.await
array of strings | null

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

budget.value
array of strings | null

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

audience.count
array of strings | null

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

movieLength
array of strings | null

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

seriesLength
array of strings | null

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

totalSeriesLength
array of strings | null

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

genres.name
array of strings | null

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

countries.name
array of strings | null

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

ticketsOnSale
array of strings | null

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

networks.items.name
array of strings | null

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

persons.id
array of strings | null

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

persons.profession
array of strings | null

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

persons.enProfession
array of strings | null

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

fees.world
array of strings | null

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

fees.usa
array of strings | null

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

fees.russia
array of strings | null

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

premiere.world
array of strings | null

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

premiere.usa
array of strings | null

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

premiere.russia
array of strings | null

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

premiere.digital
array of strings | null

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

premiere.cinema
array of strings | null

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

premiere.country
array of strings | null

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

similarMovies.id
array of strings | null

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

sequelsAndPrequels.id
array of strings | null

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

watchability.items.name
array of strings | null

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

lists
Response

Updated over 1 year ago

Did this page help you?
Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated over 1 year ago

Did this page help you?