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

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

`GET /v1.4/movie`

## Request

- Base URL: `https://api.kinopoisk.dev`
- URL: `https://api.kinopoisk.dev/v1.4/movie`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/kinopoisk/apis/api-kinopoisk-dev/docs/v1.4/movie/get.ts> (a function with typed inputs; its response is checked against the schema)

Этот метод вернет список фильмов удовлетворяющих вашему запросу. <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.dev/kinopoisk/apis/api-kinopoisk-dev.md) - [All operations](https://skmtc.dev/kinopoisk/apis/api-kinopoisk-dev/llms.txt) - [OpenAPI document](https://skmtc.dev/kinopoisk/apis/api-kinopoisk-dev/revisions/73ffd9e23f40?raw)