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

# Поиск фильмов по названию

`GET /v1.4/movie/search`

Этот метод вернет список фильмов которые подходят под ваш запрос.

## Query parameters

- `page` number
- `limit` number
- `query` string, required

## Response `200`

- SearchMovieResponseDtoV14
  - `docs` SearchMovieDtoV14[], required
    - `id` number, required
    - `name` string, required
    - `alternativeName` string, required
    - `enName` string, required
    - `type` string, required
    - `year` number, required
    - `description` string, required
    - `shortDescription` string, required
    - `movieLength` number, required
    - `names` Name[], required
      - `name` string
      - `language` string, nullable
      - `type` string, nullable
    - `externalId` ExternalId
      - `kpHD` string, nullable — ID из kinopoisk HD
      - `imdb` string, nullable
      - `tmdb` 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`
    - `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 — Количество ожидающих выхода
    - `genres` ItemName[]
      - `name` string
    - `countries` ItemName[]
      - `name` string
    - `releaseYears` YearRange[]
      - `start` number, nullable — Год начала
      - `end` number, nullable — Год окончания
    - `isSeries` boolean, required
    - `ticketsOnSale` boolean, required
    - `totalSeriesLength` number, required
    - `seriesLength` number, required
    - `ratingMpaa` string, required
    - `ageRating` number, required
    - `top10` number, nullable
    - `top250` number, nullable
    - `typeNumber` number, required
    - `status` string, required
    - `internalNames` string[], required
    - `internalRating` number, required
    - `internalVotes` 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)