v1

latestOpenAPI 3.0.02026-07-141764106.1 KB
Фильмы, сериалы, и т.д.

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

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

get/v1.4/movie/random

Query parameters

notNullFieldsstring[]

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

idstring[] nullable

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

externalId.imdbstring[] nullable

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

externalId.tmdbnumber[] nullable

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

externalId.kpHDstring[] nullable

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

typestring[] nullable

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

typeNumberstring[] nullable

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

isSeriesstring[] nullable

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

statusstring[] nullable

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

yearstring[] nullable

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

releaseYears.startstring[] nullable

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

releaseYears.endstring[] nullable

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

rating.kpstring[] nullable

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

rating.imdbstring[] nullable

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

rating.tmdbstring[] nullable

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

ratingMpaastring[] nullable

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

ageRatingstring[] nullable

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

votes.kpstring[] nullable

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

votes.imdbstring[] nullable

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

votes.tmdbstring[] nullable

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

votes.filmCriticsstring[] nullable

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

votes.russianFilmCriticsstring[] nullable

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

votes.awaitstring[] nullable

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

budget.valuestring[] nullable

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

audience.countstring[] nullable

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

movieLengthstring[] nullable

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

seriesLengthstring[] nullable

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

totalSeriesLengthstring[] nullable

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

genres.namestring[] nullable

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

countries.namestring[] nullable

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

ticketsOnSalestring[] nullable

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

networks.items.namestring[] nullable

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

persons.idstring[] nullable

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

persons.professionstring[] nullable

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

persons.enProfessionstring[] nullable

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

fees.worldstring[] nullable

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

fees.usastring[] nullable

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

fees.russiastring[] nullable

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

premiere.worldstring[] nullable

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

premiere.usastring[] nullable

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

premiere.russiastring[] nullable

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

premiere.digitalstring[] nullable

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

premiere.cinemastring[] nullable

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

premiere.countrystring[] nullable

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

similarMovies.idstring[] nullable

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

sequelsAndPrequels.idstring[] nullable

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

watchability.items.namestring[] nullable

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

listsstring[] nullable

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

Response

idnumber required

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

namestring nullable
alternativeNamestring nullable
enNamestring nullable
typestring required

Тип тайтла. Доступны: movie | tv-series | cartoon | anime | animated-series | tv-show

typeNumbernumber required

Тип тайтла в числовом обозначении. Доступны: 1 (movie) | 2 (tv-series) | 3 (cartoon) | 4 (anime) | 5 (animated-series) | 6 (tv-show)

yearnumber nullable

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

descriptionstring nullable

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

shortDescriptionstring nullable

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

sloganstring nullable

Слоган

statusstring nullable

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

movieLengthnumber nullable

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

ratingMpaastring nullable

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

ageRatingnumber nullable

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

top10number nullable

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

top250number nullable

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

ticketsOnSaleboolean nullable

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

totalSeriesLengthnumber nullable

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

seriesLengthnumber nullable

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

isSeriesboolean required

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

listsstring[] nullable

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

updatedAtstring date-time required
createdAtstring date-time required

Example response

{
  "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"
        }
      ]
    }
  ]
}