Kinopoisk Unofficial API

https://kinopoiskapiunofficial.tech/documentation/api/
Admin
Kinopoisk Unofficial API provides programmatic access to Russian film and TV show data from...
Tokens:12,324
Snippets:55
Trust Score:7.5
Update:6 months ago
Show doc for...
Tokens:
Raw
### GET /api/v1/api_keys/{apiKey}

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves details about a specific API key.

```APIDOC
## GET /api/v1/api_keys/{apiKey}

### Description
Retrieves details about a specific API key.

### Method
GET

### Endpoint
/api/v1/api_keys/{apiKey}

### Parameters
#### Path Parameters
- **apiKey** (string) - Required - The API key to retrieve details for.

### Responses
#### Success Response (200)
- **apiKey** (string) - The API key.
- **type** (string) - The type of the API key.
- **permissions** (array) - List of permissions associated with the API key.
- **limit** (integer) - The request limit for the API key.
- **offset** (integer) - The request offset for the API key.
- **createdAt** (string) - The creation date of the API key.
- **updatedAt** (string) - The last update date of the API key.

#### Error Response (429)
- **description** (string) - Too many requests. The general limit is 2 requests per second.
```

--------------------------------

### GET /api/v2.1/films/{id}/sequels_and_prequels

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves sequels and prequels for a given film ID.

```APIDOC
## GET /api/v2.1/films/{id}/sequels_and_prequels

### Description
Retrieves sequels and prequels for a given film ID.

### Method
GET

### Endpoint
/api/v2.1/films/{id}/sequels_and_prequels

### Parameters
#### Path Parameters
- **id** (integer) - Required - Kinopoisk film ID. Minimum value is 1, maximum is 12000000.

### Response
#### Success Response (200)
- **items** (array) - An array of sequel and prequel film objects.

#### Error Response
- **401** - Empty or invalid token.
- **402** - Request limit exceeded (daily or overall).
- **404** - Film not found.
- **429** - Too many requests. Overall limit of 20 requests per second.
```

--------------------------------

### GET /api/v2.2/films/premieres

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves a list of film premieres for a specified year and month.

```APIDOC
## GET /api/v2.2/films/premieres

### Description
Retrieves a list of film premieres for a specified year and month.

### Method
GET

### Endpoint
/api/v2.2/films/premieres

### Parameters
#### Query Parameters
- **year** (integer) - Required - The release year.
- **month** (string) - Required - The release month.
  - Enum: "JANUARY", "FEBRUARY", "MARCH", "APRIL", "MAY", "JUNE", "JULY", "AUGUST", "SEPTEMBER", "OCTOBER", "NOVEMBER", "DECEMBER"

### Response
#### Success Response (200)
- **items** (array) - List of film premieres.
- **total** (integer) - Total number of premieres.
- **totalPages** (integer) - Total number of pages.

#### Error Response
- **401** - Unauthorized: Empty or invalid token.
- **402** - Payment Required: Request limit exceeded (daily or overall).
- **429** - Too Many Requests: Limit of 5 requests per second.
```

--------------------------------

### GET /api/v1/media_posts

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Fetches media news from the Kinopoisk website. Each page can contain up to 20 items.

```APIDOC
## GET /api/v1/media_posts

### Description
Retrieves media news from the Kinopoisk website. Each page can contain up to 20 items.

### Method
GET

### Endpoint
/api/v1/media_posts

### Parameters
#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve. Defaults to 1. Maximum value is 50.

### Responses
#### Success Response (200)
- **items** (array) - A list of media posts.
  - Each item in the array is an object with details about a media post.
- **hasNextPage** (boolean) - Indicates if there is a next page of results.

#### Error Response (429)
- **description** (string) - Too many requests. The general limit is 20 requests per second.
```

--------------------------------

### GET /api/v1/persons

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Search for actors, directors, and other individuals by name. Results are paginated.

```APIDOC
## GET /api/v1/persons

### Description
Search for actors, directors, and other individuals by name. Results are paginated. One page can contain up to 50 items.

### Method
GET

### Endpoint
/api/v1/persons

### Parameters
#### Query Parameters
- **name** (string) - Required - The name of the person to search for.
- **page** (integer) - Optional - The page number for the search results. Defaults to 1. Maximum value is 2.

### Responses
#### Success Response (200)
- **persons** (array) - A list of persons matching the search criteria.

#### Error Responses
- **401** - Unauthorized: Empty or invalid token.
- **402** - Payment Required: Request limit exceeded (daily or overall).
- **429** - Too Many Requests: General limit of 5 requests per second.
```

--------------------------------

### GET /api/v2.2/films

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves a list of films based on various filters, with pagination. Each page contains a maximum of 20 films, and this endpoint does not return more than 400 films in total. Use /api/v2.2/films/filters to get country and genre IDs.

```APIDOC
## GET /api/v2.2/films

### Description
Retrieves a list of films based on various filters, with pagination. Each page contains a maximum of 20 films, and this endpoint does not return more than 400 films in total. Use /api/v2.2/films/filters to get country and genre IDs.

### Method
GET

### Endpoint
/api/v2.2/films

### Query Parameters
- **countries** (array[integer]) - Optional - A comma-separated list of country IDs (e.g., 1,2,3). Currently, only one country can be specified.
- **genres** (array[integer]) - Optional - A comma-separated list of genre IDs (e.g., 1,2,3). Currently, only one genre can be specified.
- **order** (string) - Optional - Sorting order. Allowed values: RATING, NUM_VOTE, YEAR. Defaults to RATING.
- **type** (string) - Optional - Type of film. Allowed values: FILM, TV_SHOW, TV_SERIES, MINI_SERIES, ALL. Defaults to ALL.
- **ratingFrom** (number) - Optional - Minimum rating. Defaults to 0.
- **ratingTo** (number) - Optional - Maximum rating. Defaults to 10.
- **yearFrom** (integer) - Optional - Minimum year. Defaults to 1000.
- **yearTo** (integer) - Optional - Maximum year. Defaults to the current year.

### Responses
#### Success Response (200)
- **content** (object) - Contains the schema for the response.
  - **application/json** (object)
    - **schema** (object)
      - **$ref** (string) - Reference to the PremiereResponse schema.

#### Error Responses
- **401** - Unauthorized: Empty or invalid token.
- **402** - Payment Required: Request limit exceeded (daily or overall).
- **429** - Too Many Requests: General limit of 5 requests per second.
```

--------------------------------

### GET /api/v1/staff/{id}

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieve details about a specific person using their Kinopoisk person ID.

```APIDOC
## GET /api/v1/staff/{id}

### Description
Retrieve details about a specific person using their Kinopoisk person ID.

### Method
GET

### Endpoint
/api/v1/staff/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk person id

### Responses
#### Success Response (200)
- **person** (object) - Details of the person.

#### Error Responses
- **401** - Unauthorized: Empty or invalid token.
- **402** - Payment Required: Request limit exceeded (daily or overall).
- **404** - Not Found: Data not found.
- **429** - Too Many Requests: General limit of 20 requests per second.
```

--------------------------------

### GET /api/v2.2/films/{id}

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves basic information about a film using its Kinopoisk ID.

```APIDOC
## GET /api/v2.2/films/{id}

### Description
Returns basic data about a film. The lastSync field indicates the date of the last data update.

### Method
GET

### Endpoint
/api/v2.2/films/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk film id

### Response
#### Success Response (200)
- **Film** (object) - Returns the film data object.

#### Error Responses
- **401** - Empty or invalid token
- **402** - Request limit exceeded
- **404** - Film not found
- **429** - Too many requests (limit 20 req/sec)
```

--------------------------------

### GET /api/v2.2/films/{id}/similars

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves a list of similar films based on the provided KinoPoisk film ID.

```APIDOC
## GET /api/v2.2/films/{id}/similars

### Description
Returns a list of films similar to the specified film.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/similars

### Parameters
#### Path Parameters
- **id** (integer) - Required - KinoPoisk film id (1-12000000)

### Response
#### Success Response (200)
- **SimilarFilmResponse** (object) - List of similar films.

#### Error Responses
- **401** - Empty or invalid token
- **402** - Request limit exceeded
- **429** - Too many requests
```

--------------------------------

### GET /api/v2.2/films/{id}/videos

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves trailers, teasers, and videos for a film by its KinoPoisk ID. Supports various sources like YouTube, Yandex Disk, and KinoPoisk widgets.

```APIDOC
## GET /api/v2.2/films/{id}/videos

### Description
Returns trailers, teasers, and videos for a film by its KinoPoisk ID. Available sources include YOUTUBE, YANDEX_DISK, and KINOPOISK_WIDGET.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/videos

### Parameters
#### Path Parameters
- **id** (integer) - Required - KinoPoisk film id (1-12000000)

### Response
#### Success Response (200)
- **VideoResponse** (object) - Returns a list of video objects.

#### Error Responses
- **401** - Empty or invalid token
- **402** - Request limit exceeded
- **429** - Too many requests (limit 20 req/sec)
```

--------------------------------

### GET /api/v2.2/films/filters

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves a list of country and genre IDs that can be used in the /api/v2.2/films endpoint.

```APIDOC
## GET /api/v2.2/films/filters

### Description
Retrieves a list of country and genre IDs that can be used in the /api/v2.2/films endpoint.

### Method
GET

### Endpoint
/api/v2.2/films/filters

### Responses
#### Success Response (200)
- **content** (object) - Contains the schema for the response.
  - **application/json** (object)
    - **schema** (object)
      - **$ref** (string) - Reference to the PremiereResponse schema.

#### Error Responses
- **401** - Unauthorized: Empty or invalid token.
- **402** - Payment Required: Request limit exceeded (daily or overall).
- **429** - Too Many Requests: General limit of 20 requests per second.
```

--------------------------------

### GET /api/v2.2/films/{id}/distributions

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves distribution data for a film across different countries.

```APIDOC
## GET /api/v2.2/films/{id}/distributions

### Description
Returns distribution data for a film in different countries.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/distributions

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk film id

### Response
#### Success Response (200)
- **DistributionResponse** (object) - Data about film distribution
```

--------------------------------

### GET /api/v2.2/films/{id}/reviews

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Fetches a list of user reviews for a given film ID with pagination. Each page contains a maximum of 20 reviews.

```APIDOC
## GET /api/v2.2/films/{id}/reviews

### Description
Fetches a list of user reviews for a given film ID with pagination. Each page contains a maximum of 20 reviews. Reviews can be sorted by date or user rating.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/reviews

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk film id

#### Query Parameters
- **page** (integer) - Optional - номер страницы. Default: 1
- **order** (string) - Optional - тип сортировки. Default: DATE_DESC. Enum: DATE_ASC, DATE_DESC, USER_POSITIVE_RATING_ASC, USER_POSITIVE_RATING_DESC, USER_NEGATIVE_RATING_ASC, USER_NEGATIVE_RATING_DESC

### Response
#### Success Response (200)
- **reviews** (array) - List of reviews.
- **pageInfo** (object) - Information about the current page.

#### Response Example
{
  "reviews": [
    {
      "reviewId": 0,
      "type": "POSITIVE",
      "title": "string",
      "date": "string",
      "description": "string",
      "authorInfo": {
        "buttonText": "string",
        "name": "string",
        "posterUrl": "string",
        "profileUrl": "string"
      },
      "userRating": 0,
      "isSpoiler": true,
      "reviewStatus": "ALLOW",
      "ratingCourse": 0,
      "ratingVoteCount": 0,
      "dislikes": 0,
      "likes": 0
    }
  ],
  "pageInfo": {
    "pageCount": 0,
    "currentPage": 0,
    "pageSize": 0,
    "totalCount": 0
  }
}

#### Error Responses
- **401** - Пустой или неправильный токен
- **402** - Превышен лимит запросов(или дневной, или общий)
- **429** - Слишком много запросов. Общий лимит - 20 запросов в секунду
```

--------------------------------

### GET /api/v2.1/films/search-by-filters

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Searches for films based on specified filters. Supports pagination.

```APIDOC
## GET /api/v2.1/films/search-by-filters

### Description
Searches for films based on specified filters. Supports pagination.

### Method
GET

### Endpoint
/api/v2.1/films/search-by-filters

### Parameters
#### Query Parameters
- **year** (integer) - Optional - Year of release.
- **imdbId** (string) - Optional - IMDB ID of the film.
- **keyword** (string) - Optional - Keyword that appears in the film title.
- **page** (integer) - Optional - Page number. Defaults to 1. Maximum value is 20, minimum is 1.

### Response
#### Success Response (200)
- **data** (object) - Contains film search results.
- **total** (integer) - Total number of films found.
- **totalPages** (integer) - Total number of pages.

#### Error Response
- **401** - Empty or invalid token.
- **402** - Request limit exceeded (daily or overall).
- **429** - Too many requests. Limit of 5 requests per second.
```

--------------------------------

### GET /api/v2.2/films/{id}/external_sources

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves a list of websites where the film can be watched, based on the film's Kinopoisk ID.

```APIDOC
## GET /api/v2.2/films/{id}/external_sources

### Description
Retrieves a list of websites where the film can be watched, based on the film's Kinopoisk ID.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/external_sources

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk film id

### Response
#### Success Response (200)
- **items** (array) - List of external sources.

#### Response Example
{
  "items": [
    {
      "name": "string",
      "url": "string",
      "logoUrl": "string",
      "priority": 0
    }
  ]
}

#### Error Responses
- **401** - Пустой или неправильный токен
- **402** - Превышен лимит запросов(или дневной, или общий)
- **429** - Слишком много запросов. Общий лимит - 20 запросов в секунду
```

--------------------------------

### GET /api/v2.2/films/{id}/relations

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves a list of related films for a given KinoPoisk film ID.

```APIDOC
## GET /api/v2.2/films/{id}/relations

### Description
Returns a list of films related to the specified film.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/relations

### Parameters
#### Path Parameters
- **id** (integer) - Required - KinoPoisk film id (1-12000000)

### Response
#### Success Response (200)
- **RelatedFilmResponse** (object) - List of related films.

#### Error Responses
- **401** - Empty or invalid token
- **402** - Request limit exceeded
- **429** - Too many requests
```

--------------------------------

### GET /api/v2.1/films/search-by-keyword

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Searches for films by keywords. Returns paginated results with a maximum of 20 films per page.

```APIDOC
## GET /api/v2.1/films/search-by-keyword

### Description
Searches for films by keywords. Returns paginated results with a maximum of 20 films per page.

### Method
GET

### Endpoint
/api/v2.1/films/search-by-keyword

### Parameters
#### Query Parameters
- **keyword** (string) - Required - Keywords for the search.
- **page** (integer) - Optional - Page number. Defaults to 1. Maximum value is 20, minimum is 1.

### Response
#### Success Response (200)
- **films** (array) - An array of film objects matching the keyword.
- **total** (integer) - Total number of films found.
- **totalPages** (integer) - Total number of pages.

#### Error Response
- **401** - Empty or invalid token.
- **402** - Request limit exceeded (daily or overall).
- **404** - Films not found.
- **429** - Too many requests. Limit of 5 requests per second.
```

--------------------------------

### GET /api/v2.2/films/{id}/facts

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves interesting facts and bloopers for a film by its Kinopoisk ID.

```APIDOC
## GET /api/v2.2/films/{id}/facts

### Description
Returns a list of facts and errors in a film. Type FACT denotes an interesting fact, while BLOOPER denotes an error.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/facts

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk film id

### Response
#### Success Response (200)
- **Response** (object) - Returns a list of facts and bloopers.
```

--------------------------------

### GET /api/v2.2/films/{id}/awards

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves information about awards and nominations for a specific film.

```APIDOC
## GET /api/v2.2/films/{id}/awards

### Description
Returns data about awards and prizes received by the film.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/awards

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk film id

### Response
#### Success Response (200)
- **AwardResponse** (object) - Data about film awards
```

--------------------------------

### GET /api/v1/kp_users/{id}/votes

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieve a user's voting data from Kinopoisk. Limited to approximately the last 1500 votes and paginated.

```APIDOC
## GET /api/v1/kp_users/{id}/votes

### Description
Retrieve a user's voting data from Kinopoisk. Limited to approximately the last 1500 votes and paginated. One page can contain up to 20 items.

### Method
GET

### Endpoint
/api/v1/kp_users/{id}/votes

### Parameters
#### Path Parameters
- **id** (integer) - Required - The user ID on the Kinopoisk website.
#### Query Parameters
- **page** (integer) - Optional - The page number for the voting data. Maximum value is 100.

### Responses
#### Success Response (200)
- **votes** (array) - A list of the user's votes.

#### Error Responses
- **401** - Unauthorized: Empty or invalid token.
- **402** - Payment Required: Request limit exceeded (daily or overall).
- **404** - Not Found: Data not found.
- **429** - Too Many Requests: General limit of 20 requests per second.
```

--------------------------------

### GET /api/v2.2/films/{id}/seasons

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves season information for a specific TV series by its Kinopoisk ID.

```APIDOC
## GET /api/v2.2/films/{id}/seasons

### Description
Returns data about the seasons for a TV series.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/seasons

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk film id

### Response
#### Success Response (200)
- **SeasonResponse** (object) - Returns the season data object.

#### Error Responses
- **401** - Empty or invalid token
- **402** - Request limit exceeded
- **429** - Too many requests (limit 20 req/sec)
```

--------------------------------

### GET /api/v2.2/films/collections

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves a list of films from various top lists or collections, with pagination. Each page contains a maximum of 20 films.

```APIDOC
## GET /api/v2.2/films/collections

### Description
Retrieves a list of films from various top lists or collections, with pagination. Each page contains a maximum of 20 films.

### Method
GET

### Endpoint
/api/v2.2/films/collections

### Parameters
#### Query Parameters
- **type** (string) - Optional - The type of top list or collection. Defaults to "TOP_POPULAR_ALL".
  - Enum: "TOP_POPULAR_ALL", "TOP_POPULAR_MOVIES", "TOP_250_TV_SHOWS", "TOP_250_MOVIES", "VAMPIRE_THEME", "COMICS_THEME", "CLOSES_RELEASES", "FAMILY", "OSKAR_WINNERS_2021", "LOVE_THEME", "ZOMBIE_THEME", "CATASTROPHE_THEME", "KIDS_ANIMATION_THEME", "POPULAR_SERIES"
- **page** (integer) - Optional - The page number. Defaults to 1. Minimum 1, Maximum 50.

### Response
#### Success Response (200)
- **items** (array) - List of films in the collection.
- **total** (integer) - Total number of films available for the given collection.
- **totalPages** (integer) - Total number of pages available.

#### Error Response
- **401** - Unauthorized: Empty or invalid token.
- **402** - Payment Required: Request limit exceeded (daily or overall).
- **429** - Too Many Requests: Limit of 5 requests per second.
```

--------------------------------

### GET /api/v2.2/films/{id}/box_office

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves budget and box office collection data for a specific film.

```APIDOC
## GET /api/v2.2/films/{id}/box_office

### Description
Returns data about the budget and box office collections of a film.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/box_office

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk film id

### Response
#### Success Response (200)
- **BoxOfficeResponse** (object) - Data about budget and box office
```

--------------------------------

### GET /api/v1/films/filmId/staff

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieve staff (actors, directors, etc.) associated with a specific Kinopoisk film ID.

```APIDOC
## GET /api/v1/films/filmId/staff

### Description
Retrieve staff (actors, directors, etc.) associated with a specific Kinopoisk film ID.

### Method
GET

### Endpoint
/api/v1/films/filmId/staff

### Parameters
#### Query Parameters
- **filmId** (integer) - Required - kinopoisk film id

### Responses
#### Success Response (200)
- **staff** (array) - List of staff members associated with the film.

#### Error Responses
- **401** - Unauthorized: Empty or invalid token.
- **402** - Payment Required: Request limit exceeded (daily or overall).
- **404** - Not Found: Data not found.
- **429** - Too Many Requests: General limit of 20 requests per second.
```

--------------------------------

### GET /api/v2.2/films/{id}/images

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves images associated with a film, with support for pagination and image type filtering. Up to 20 images are returned per page.

```APIDOC
## GET /api/v2.2/films/{id}/images

### Description
Retrieves images associated with a film, with support for pagination and image type filtering. Up to 20 images are returned per page. Available image types include STILL, SHOOTING, POSTER, FAN_ART, PROMO, CONCEPT, WALLPAPER, COVER, and SCREENSHOT.

### Method
GET

### Endpoint
/api/v2.2/films/{id}/images

### Parameters
#### Path Parameters
- **id** (integer) - Required - kinopoisk film id

#### Query Parameters
- **type** (string) - Optional - тип изображения. Default: STILL. Enum: STILL, SHOOTING, POSTER, FAN_ART, PROMO, CONCEPT, WALLPAPER, COVER, SCREENSHOT
- **page** (integer) - Optional - номер страницы. Default: 1

### Response
#### Success Response (200)
- **items** (array) - List of images.
- **total** (integer) - Total number of images.
- **totalPages** (integer) - Total number of pages.

#### Response Example
{
  "items": [
    {
      "imageUrl": "string",
      "previewUrl": "string"
    }
  ],
  "total": 0,
  "totalPages": 0
}

#### Error Responses
- **401** - Пустой или неправильный токен
- **402** - Превышен лимит запросов(или дневной, или общий)
- **429** - Слишком много запросов. Общий лимит - 20 запросов в секунду
```

--------------------------------

### Season Information

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves information about seasons for a given series.

```APIDOC
## GET /api/v1/movie/{id}/seasons

### Description
Retrieves information about the seasons of a specific series.

### Method
GET

### Endpoint
/api/v1/movie/{id}/seasons

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the series.

### Response
#### Success Response (200)
- **total** (integer) - The total number of seasons.
- **items** (array) - An array of season objects.

#### Response Example
{
  "total": 5,
  "items": [
    {
      "seasonNumber": 1,
      "episodes": [
        {
          "episodeNumber": 1
        }
      ]
    }
  ]
}
```

--------------------------------

### Data Schemas Overview

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Definitions of the response objects used across the KinoPoisk API for persons, images, and premieres.

```APIDOC
## Data Schemas

### PersonResponse
- **posterUrl** (string) - URL to actor poster
- **growth** (string) - Height of the person
- **birthday** (string) - Birth date
- **death** (string) - Death date
- **age** (integer) - Current age
- **birthplace** (string) - Place of birth
- **deathplace** (string) - Place of death
- **hasAwards** (integer) - Award count
- **profession** (string) - List of professions
- **facts** (array) - List of facts
- **spouses** (array) - List of spouses
- **films** (array) - List of films

### PersonByNameResponse
- **total** (integer) - Total count of persons found
- **items** (array) - List of person objects

### ImageResponse
- **total** (integer) - Total count of images
- **totalPages** (integer) - Number of available pages
- **items** (array) - List of image objects

### PremiereResponse
- **total** (integer) - Total count of premieres
- **items** (array) - List of premiere items

### PremiereResponseItem
- **kinopoiskId** (integer) - Unique ID
- **nameRu** (string) - Russian title
- **nameEn** (string) - English title
- **year** (integer) - Release year
- **posterUrl** (string) - Poster URL
- **posterUrlPreview** (string) - Preview poster URL
- **countries** (array) - List of countries
- **genres** (array) - List of genres
- **duration** (integer) - Duration in minutes
- **premiereRu** (string) - Russian premiere date
```

--------------------------------

### Distribution Information

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves distribution details for a movie or series, such as distributors and their countries.

```APIDOC
## GET /api/v1/movie/{id}/distributions

### Description
Retrieves distribution information for a specific movie or series.

### Method
GET

### Endpoint
/api/v1/movie/{id}/distributions

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the movie or series.

### Response
#### Success Response (200)
- **total** (integer) - The total number of distribution entries.
- **items** (array) - An array of distribution objects.

#### Response Example
{
  "total": 5,
  "items": [
    {
      "type": "DISTRIBUTOR",
      "name": "Warner Bros. Pictures"
    }
  ]
}
```

--------------------------------

### Movie/Series Details

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves detailed information about a specific movie or series, including its genre, country, start/end years, and completion status.

```APIDOC
## GET /api/v1/movie/{id}

### Description
Retrieves detailed information about a specific movie or series.

### Method
GET

### Endpoint
/api/v1/movie/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the movie or series.

### Response
#### Success Response (200)
- **items** (array) - An array of movie/series objects.
  - **genres** (array) - An array of genre objects.
  - **countries** (array) - An array of country objects.
  - **startYear** (integer) - The year the movie/series started.
  - **endYear** (integer) - The year the movie/series ended.
  - **serial** (boolean) - Indicates if the item is a series.
  - **shortFilm** (boolean) - Indicates if the item is a short film.
  - **completed** (boolean) - Indicates if the movie/series is completed.

#### Response Example
{
  "items": [
    {
      "genres": [
        {
          "name": "фантастика",
          "slug": "fantastic"
        }
      ],
      "countries": [
        {
          "name": "США",
          "slug": "usa"
        }
      ],
      "startYear": 1996,
      "endYear": 1996,
      "serial": false,
      "shortFilm": false,
      "completed": false
    }
  ]
}
```

--------------------------------

### Data Schemas Definition

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Definitions for core data structures used across the API endpoints.

```APIDOC
## Data Schemas

### AwardPerson
- **kinopoiskId** (integer) - Required - Unique identifier
- **webUrl** (string) - Required - URL to profile
- **nameRu** (string) - Required - Russian name
- **nameEn** (string) - Required - English name
- **sex** (string) - Required - Gender (MALE/FEMALE)
- **posterUrl** (string) - Required - URL to poster image
- **growth** (integer) - Required - Height in cm
- **birthday** (string) - Required - Birth date (YYYY-MM-DD)
- **death** (string) - Required - Death date (YYYY-MM-DD)
- **age** (integer) - Required - Age
- **birthplace** (string) - Required - Place of birth
- **deathplace** (string) - Required - Place of death
- **profession** (string) - Required - List of professions

### Distribution
- **type** (string) - Required - Distribution type (LOCAL, COUNTRY_SPECIFIC, PREMIERE, ALL, WORLD_PREMIER)
- **subType** (string) - Required - Distribution sub-type (CINEMA, DVD, DIGITAL, BLURAY)
- **date** (string) - Required - Release date
- **reRelease** (boolean) - Required - Re-release flag
- **country** (object) - Required - Country object
- **companies** (array) - Required - List of companies

### Season
- **number** (integer) - Required - Season number
- **episodes** (array) - Required - List of episodes

### Episode
- **seasonNumber** (integer) - Required - Season number
- **episodeNumber** (integer) - Required - Episode number
- **nameRu** (string) - Required - Russian name
- **nameEn** (string) - Required - English name
- **releaseDate** (string) - Required - Release date
- **synopsis** (string) - Required - Episode summary
```

--------------------------------

### Media Posts API Endpoint

Source: https://kinopoiskapiunofficial.tech/documentation/api

Endpoint for retrieving media news posts from the Kinopoisk website.

```APIDOC
## GET /api/v1/media_posts

### Description
Get media news posts from the Kinopoisk website.

### Method
GET

### Endpoint
/api/v1/media_posts

### Parameters
#### Query Parameters
- **page** (integer) - Optional - Page number
- **limit** (integer) - Optional - Number of posts per page

### Response
#### Success Response (200)
- **MediaPostsResponse** (object) - List of media news posts
```

--------------------------------

### Box Office Information

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves box office revenue and budget information for a movie.

```APIDOC
## GET /api/v1/movie/{id}/box_office

### Description
Retrieves box office information for a specific movie.

### Method
GET

### Endpoint
/api/v1/movie/{id}/box_office

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the movie.

### Response
#### Success Response (200)
- **total** (integer) - The total number of box office entries.
- **items** (array) - An array of box office objects.
  - **type** (string) - The type of box office data (e.g., "BUDGET", "WORLD").
  - **amount** (integer) - The monetary amount.
  - **currencyCode** (string) - The currency code (e.g., "USD").
  - **name** (string) - The name of the currency.
  - **symbol** (string) - The symbol of the currency.

#### Response Example
{
  "total": 5,
  "items": [
    {
      "type": "BUDGET",
      "amount": 63000000,
      "currencyCode": "USD",
      "name": "US Dollar",
      "symbol": "$"
    }
  ]
}
```

--------------------------------

### StaffResponse Schema

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Defines the structure for staff members involved in a film production.

```APIDOC
## StaffResponse

### Description
Represents a person involved in the production of a film.

### Response
- **staffId** (integer) - Unique identifier for the staff member
- **nameRu** (string) - Name in Russian
- **nameEn** (string) - Name in English
- **description** (string) - Role description
- **posterUrl** (string) - URL to the staff member's photo
- **professionText** (string) - Profession description
- **professionKey** (string) - Profession category key (e.g., DIRECTOR, ACTOR)
```

--------------------------------

### Embed KinoPoisk Video Widget

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Use this HTML snippet to embed a KinoPoisk video widget on a webpage. Note that the video content is only accessible from Russian IP addresses.

```html
<script src="https://unpkg.com/@ungap/custom-elements-builtin"></script>
<script type="module" src="https://unpkg.com/x-frame-bypass"></script>
<iframe is="x-frame-bypass" src="https://widgets.kinopoisk.ru/discovery/trailer/167560?onlyPlayer=1&autoplay=1&cover=1" width="500" height="500"></iframe>
```

--------------------------------

### API Keys API Endpoint

Source: https://kinopoiskapiunofficial.tech/documentation/api

Endpoint for retrieving information about an API key, including quota details.

```APIDOC
## GET /api/v1/api_keys/{apiKey}

### Description
Get information about an API key, including total and daily quotas.

### Method
GET

### Endpoint
/api/v1/api_keys/{apiKey}

### Parameters
#### Path Parameters
- **apiKey** (string) - Required - The API key to check

### Response
#### Success Response (200)
- **ApiKeyResponse** (object) - API key details and quota information
```

--------------------------------

### Awards Information

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves information about awards and nominations for a movie or series.

```APIDOC
## GET /api/v1/movie/{id}/awards

### Description
Retrieves award information for a specific movie or series.

### Method
GET

### Endpoint
/api/v1/movie/{id}/awards

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the movie or series.

### Response
#### Success Response (200)
- **total** (integer) - The total number of awards.
- **items** (array) - An array of award objects.
  - **name** (string) - The name of the award.
  - **win** (boolean) - Indicates if the award was won.
  - **imageUrl** (string) - URL of the award image.
  - **nominationName** (string) - The name of the nomination.
  - **year** (integer) - The year the award was given.

#### Response Example
{
  "total": 5,
  "items": [
    {
      "name": "Оскар",
      "win": true,
      "imageUrl": "https://avatars.mds.yandex.net/get-kinopoisk-image/1600647/09035193-2458-4de7-a7df-ad8f85b73798/orig",
      "nominationName": "Best Picture",
      "year": 1996
    }
  ]
}
```

--------------------------------

### Staff API Endpoints

Source: https://kinopoiskapiunofficial.tech/documentation/api

Endpoints for retrieving data about film staff, such as actors and directors.

```APIDOC
## GET /api/v1/staff

### Description
Get data about staff (actors, directors, etc.) associated with a film by Kinopoisk film ID.

### Method
GET

### Endpoint
/api/v1/staff

### Parameters
#### Query Parameters
- **filmId** (integer) - Required - Kinopoisk film ID
- **count** (integer) - Optional - Number of staff members to retrieve
- **offset** (integer) - Optional - Offset for pagination

### Response
#### Success Response (200)
- **StaffResponse** (object) - List of staff members

## GET /api/v1/staff/{id}

### Description
Get data about a specific person by their Kinopoisk person ID.

### Method
GET

### Endpoint
/api/v1/staff/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - Kinopoisk person ID

### Response
#### Success Response (200)
- **PersonResponse** (object) - Detailed information about the person
```

--------------------------------

### ReviewResponse Schema

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Defines the structure for film review data, including totals for different sentiment categories.

```APIDOC
## ReviewResponse

### Description
Represents the collection of user reviews for a film.

### Response
- **total** (integer) - Суммарное кол-во пользовательских рецензий
- **totalPages** (integer) - Total number of pages
- **totalPositiveReviews** (integer) - Count of positive reviews
- **totalNegativeReviews** (integer) - Count of negative reviews
- **totalNeutralReviews** (integer) - Count of neutral reviews
- **items** (array) - List of review objects
```

--------------------------------

### Facts about a Movie/Series

Source: https://kinopoiskapiunofficial.tech/documentation/api/openapi.json

Retrieves interesting facts or bloopers related to a specific movie or series.

```APIDOC
## GET /api/v1/movie/{id}/facts

### Description
Retrieves facts or bloopers associated with a specific movie or series.

### Method
GET

### Endpoint
/api/v1/movie/{id}/facts

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the movie or series.

### Response
#### Success Response (200)
- **total** (integer) - The total number of facts.
- **items** (array) - An array of fact objects.
  - **text** (string) - The content of the fact.
  - **type** (string) - The type of the fact (e.g., "FACT", "BLOOPER").
  - **spoiler** (boolean) - Indicates if the fact contains spoilers.

#### Response Example
{
  "total": 5,
  "items": [
    {
      "text": "В эпизоде, где Тринити и Нео в поисках Морфиуса оказываются на крыше...",
      "type": "BLOOPER",
      "spoiler": false
    }
  ]
}
```

--------------------------------

### Kinopoisk Users API Endpoint

Source: https://kinopoiskapiunofficial.tech/documentation/api

Endpoint for retrieving a user's votes by their Kinopoisk user ID.

```APIDOC
## GET /api/v1/kp_users/{id}/votes

### Description
Get a user's voting data by their Kinopoisk user ID.

### Method
GET

### Endpoint
/api/v1/kp_users/{id}/votes

### Parameters
#### Path Parameters
- **id** (integer) - Required - Kinopoisk user ID

### Response
#### Success Response (200)
- **KinopoiskUserVoteResponse** (object) - User's voting information
```

--------------------------------

### Persons API Endpoint

Source: https://kinopoiskapiunofficial.tech/documentation/api

Endpoint for searching persons (actors, directors, etc.) by name.

```APIDOC
## GET /api/v1/persons

### Description
Search for actors, directors, and other persons by name.

### Method
GET

### Endpoint
/api/v1/persons

### Parameters
#### Query Parameters
- **name** (string) - Required - The name to search for
- **page** (integer) - Optional - Page number

### Response
#### Success Response (200)
- **PersonByNameResponse** (object) - List of persons matching the name
```
Tokens:
Raw