v1

latestOpenAPI 3.0.02026-07-141764106.1 KB

Фильмы, сериалы, и т.д.

Поиск по id

Возвращает всю доступную информацию о сущности.

get/v1.4/movie/{id}

Path parameters

idnumber required

ID из кинопоиска

Response

idnumber required

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

namestring nullable

alternativeNamestring nullable

enNamestring nullable

typestring required

typeNumbernumber required

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