---
title: "Универсальный поиск с фильтрами"
method: GET
path: "/v1.4/movie"
tags: ["Фильмы, сериалы, и т.д."]
---

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

`GET /v1.4/movie`

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

## Query parameters

- `page` number
- `limit` number
- `selectFields` string[]
- `notNullFields` string[]
- `sortField` string[]
- `sortType` string[]
- `id` string[], nullable
- `externalId.imdb` string[], nullable
- `externalId.tmdb` number[], nullable
- `externalId.kpHD` string[], nullable
- `type` string[], nullable
- `typeNumber` string[], nullable
- `isSeries` string[], nullable
- `status` string[], nullable
- `year` string[], nullable
- `releaseYears.start` string[], nullable
- `releaseYears.end` string[], nullable
- `rating.kp` string[], nullable
- `rating.imdb` string[], nullable
- `rating.tmdb` string[], nullable
- `ratingMpaa` string[], nullable
- `ageRating` string[], nullable
- `votes.kp` string[], nullable
- `votes.imdb` string[], nullable
- `votes.tmdb` string[], nullable
- `votes.filmCritics` string[], nullable
- `votes.russianFilmCritics` string[], nullable
- `votes.await` string[], nullable
- `budget.value` string[], nullable
- `audience.count` string[], nullable
- `movieLength` string[], nullable
- `seriesLength` string[], nullable
- `totalSeriesLength` string[], nullable
- `genres.name` string[], nullable
- `countries.name` string[], nullable
- `ticketsOnSale` string[], nullable
- `networks.items.name` string[], nullable
- `persons.id` string[], nullable
- `persons.profession` string[], nullable
- `persons.enProfession` string[], nullable
- `fees.world` string[], nullable
- `fees.usa` string[], nullable
- `fees.russia` string[], nullable
- `premiere.world` string[], nullable
- `premiere.usa` string[], nullable
- `premiere.russia` string[], nullable
- `premiere.digital` string[], nullable
- `premiere.cinema` string[], nullable
- `premiere.country` string[], nullable
- `similarMovies.id` string[], nullable
- `sequelsAndPrequels.id` string[], nullable
- `watchability.items.name` string[], nullable
- `lists` string[], nullable
- `updatedAt` string[], nullable
- `createdAt` string[], nullable

## Response `200`

- MovieDocsResponseDtoV14
  - `docs` MovieDtoV14[], required
    - `id` number, required — Id фильма с кинопоиска
    - `externalId` ExternalId, required
      - `kpHD` string, nullable — ID из kinopoisk HD
      - `imdb` string, nullable
      - `tmdb` number, nullable
    - `name` string, nullable
    - `alternativeName` string, nullable
    - `enName` string, nullable
    - `names` Name[], required
      - `name` string
      - `language` string, nullable
      - `type` string, nullable
    - `type` string, required — Тип тайтла. Доступны: movie | tv-series | cartoon | anime | animated-series | tv-show
    - `typeNumber` number, required — Тип тайтла в числовом обозначении. Доступны: 1 (movie) | 2 (tv-series) | 3 (cartoon) | 4 (anime) | 5 (animated-series) | 6 (tv-show)
    - `year` number, nullable — Год премьеры. При поиске по этому полю, можно использовать интервалы 1860-2030
    - `description` string, nullable — Описание тайтла
    - `shortDescription` string, nullable — Сокращенное описание
    - `slogan` string, nullable — Слоган
    - `status` string, nullable — Статус релиза тайтла. Доступные значения: filming | pre-production | completed | announced | post-production
    - `rating` Rating
      - `kp` number, nullable — Рейтинг кинопоиска
      - `imdb` number, nullable — Рейтинг IMDB
      - `tmdb` number, nullable — Рейтинг TMDB
      - `filmCritics` number, nullable — Рейтинг кинокритиков
      - `russianFilmCritics` number, nullable — Рейтинг кинокритиков из РФ
      - `await` number, nullable — Рейтинг основанный на ожиданиях пользователей
    - `votes` Votes
      - `kp` string, nullable
      - `imdb` number, nullable
      - `tmdb` number, nullable
      - `filmCritics` number, nullable — Количество голосов кинокритиков
      - `russianFilmCritics` number, nullable — Количество голосов кинокритиков из РФ
      - `await` number, nullable — Количество ожидающих выхода
    - `movieLength` number, nullable — Продолжительность фильма
    - `ratingMpaa` string, nullable — Возрастной рейтинг по MPAA
    - `ageRating` number, nullable — Возрастной рейтинг
    - `logo` Logo
      - `url` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
    - `poster` ShortImage
      - `url` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
      - `previewUrl` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
    - `backdrop` ShortImage
      - `url` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
      - `previewUrl` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
    - `videos` VideoTypes
      - `trailers` Video[]
        - `url` string, nullable — Url трейлера
        - `name` string, nullable
        - `site` string, nullable
        - `type` string, nullable
        - `size` number, required
      - `teasers` Video[], required
        - `url` string, nullable — Url трейлера
        - `name` string, nullable
        - `site` string, nullable
        - `type` string, nullable
        - `size` number, required
    - `genres` ItemName[]
      - `name` string
    - `countries` ItemName[]
      - `name` string
    - `persons` PersonInMovie[]
      - `id` number, nullable — Id персоны с кинопоиска
      - `photo` string, nullable
      - `name` string, nullable
      - `enName` string, nullable
      - `description` string, required
      - `profession` string, required
      - `enProfession` string, required
    - `reviewInfo` ReviewInfo
      - `count` number, nullable
      - `positiveCount` number, nullable
      - `percentage` string, nullable
    - `seasonsInfo` SeasonInfo[]
      - `number` number, nullable
      - `episodesCount` number, nullable
    - `budget` CurrencyValue
      - `value` number, nullable — Сумма
      - `currency` string, nullable — Валюта
    - `fees` Fees
      - `world` CurrencyValue
        - `value` number, nullable — Сумма
        - `currency` string, nullable — Валюта
      - `russia` CurrencyValue
        - `value` number, nullable — Сумма
        - `currency` string, nullable — Валюта
      - `usa` CurrencyValue
        - `value` number, nullable — Сумма
        - `currency` string, nullable — Валюта
    - `premiere` Premiere
      - `country` string, nullable
      - `world` string, date-time, nullable — Для более релевантного поиска, используйте интервал дат 01.02.2022-01.02.2023
      - `russia` string, date-time, nullable — Для более релевантного поиска, используйте интервал дат 01.02.2022-01.02.2023
      - `digital` string, nullable
      - `cinema` string, date-time, nullable — Для более релевантного поиска, используйте интервал дат 01.02.2022-01.02.2023
      - `bluray` string, required
      - `dvd` string, required
    - `similarMovies` LinkedMovieV14[]
      - `id` number, nullable
      - `rating` Rating, required
        - `kp` number, nullable — Рейтинг кинопоиска
        - `imdb` number, nullable — Рейтинг IMDB
        - `tmdb` number, nullable — Рейтинг TMDB
        - `filmCritics` number, nullable — Рейтинг кинокритиков
        - `russianFilmCritics` number, nullable — Рейтинг кинокритиков из РФ
        - `await` number, nullable — Рейтинг основанный на ожиданиях пользователей
      - `year` number, required
      - `name` string, required
      - `enName` string, required
      - `alternativeName` string, required
      - `type` string
      - `poster` ShortImage, required
        - `url` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
        - `previewUrl` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
    - `sequelsAndPrequels` LinkedMovieV14[]
      - `id` number, nullable
      - `rating` Rating, required
        - `kp` number, nullable — Рейтинг кинопоиска
        - `imdb` number, nullable — Рейтинг IMDB
        - `tmdb` number, nullable — Рейтинг TMDB
        - `filmCritics` number, nullable — Рейтинг кинокритиков
        - `russianFilmCritics` number, nullable — Рейтинг кинокритиков из РФ
        - `await` number, nullable — Рейтинг основанный на ожиданиях пользователей
      - `year` number, required
      - `name` string, required
      - `enName` string, required
      - `alternativeName` string, required
      - `type` string
      - `poster` ShortImage, required
        - `url` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
        - `previewUrl` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
    - `watchability` Watchability
      - `items` WatchabilityItem[]
        - `name` string, nullable
        - `logo` Logo, required
          - `url` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
        - `url` string, required
    - `releaseYears` YearRange[]
      - `start` number, nullable — Год начала
      - `end` number, nullable — Год окончания
    - `top10` number, nullable — Позиция тайтла в топ 10. Чтобы найти фильмы участвующие в рейтинге используйте: `!null`
    - `top250` number, nullable — Позиция тайтла в топ 250. Чтобы найти фильмы участвующие в рейтинге используйте: `!null`
    - `ticketsOnSale` boolean, nullable — Признак того, что тайтл находится в прокате
    - `totalSeriesLength` number, nullable — Продолжительность всех серий
    - `seriesLength` number, nullable — Средняя продолжительность серии
    - `isSeries` boolean, required — Признак сериала
    - `audience` Audience[], nullable
      - `count` number, required — Количество просмотров в кино
      - `country` string, required — Страна в которой проходил показ
    - `lists` string[], nullable — Список коллекций, в которых находится тайтл.
    - `networks` NetworksV14[], required
      - `items` NetworkItemV14[], required
        - `name` string, required
        - `logo` Logo, required
          - `url` string, nullable — Чтобы найти фильмы с этим полем, используйте: `!null`
    - `updatedAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `facts` FactInMovie[], required
      - `value` string, required
      - `type` string, required
      - `spoiler` boolean, required
    - `imagesInfo` Images, required
      - `postersCount` number, required
      - `backdropsCount` number, required
      - `framesCount` number, required
  - `total` number, required — Общее количество результатов
  - `limit` number, required — Количество результатов на странице
  - `page` number, required — Текущая страница
  - `pages` number, required — Сколько страниц всего

---

[API](https://skmtc.net/kinopoisk/apis/api-kinopoisk-dev.md) · [All operations](https://skmtc.net/kinopoisk/apis/api-kinopoisk-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kinopoisk/api-kinopoisk-dev/revisions/73ffd9e23f40/schema)