Movies and TV series

Eligible sites

Streaming services and online media.

What it adds to search results

An answer with information about the cost and terms of watching a movie or TV series. In such an answer, the user can immediately play the video if they have the required subscription. A user without a subscription can subscribe, or they can buy or rent the movie after going to the partner site from the answer.

Partner offers within an answer are displayed in random order. However, if the user has a subscription, the offers associated with it may be displayed in higher positions.

How to set it up

For content from streaming services to appear in such answers, Yandex provides a mechanism of indexing in Yandex Search. A streaming service needs to prepare a file with information about movies and TV series in JSON format.

One streaming service can provide only one file.
The streaming service logo must meet the requirements.
After the file is posted, you can make changes to it. Make sure that the information doesn't become outdated and regularly update the file. Yandex will regularly crawl the file and update the information in the answer.

Offers can also be automatically included in the response based on the processing of data from the Yandex search robot.

Sending data to Yandex

Prepare the file and submit a link to it to Yandex using the form at the bottom of the page.

For your file to be processed correctly, it must meet the requirements:

The file must conform to JSON format.
The file must be accessible in the streaming service's domain via the HTTPS protocol. An example of a link to the file: https://yoursite.ru/feed.json.
If authentication is required to access the file, specify the login and password when submitting a link to the file.

Data format

You can use the link below to download a sample JSON file with a complete content description. It includes two movies and one TV series.

Download the example

The file must contain the service name, a link to the home page, and content descriptions. There are no limits on the number of content pieces in a single file.

{
  "serviceName": "Cinema N",
  "url": "https://yoursite.ru",
  "items": [{
    ...
    objects that describe movies or TV shows
    ...
  }]
}

Parameter descriptions

Key	Value	Data type	Required for creating a feed
`serviceName`	Service name in Russian or English. This name will be displayed in the object response in Search.	String	Yes
`url`	A link to the site's home page.	String	Yes
`items`	Array of content units. See below for more details on movie and series parameters.	Array of JSON objects	Yes

A movie object in the "items" array

A content object contains basic information about a movie or TV series with a specific monetization model (like subscription or purchase) for a specific distribution region.

Place movie objects in the items array.

Note

All combinations of the kpId, monetizationModel, and region attribute values must be unique across the file.

Movie object

{
        "title": "Ashes of Time",
        "kpId": "414157",
        "url": "https://www.ivi.ru/watch/2476",
        "addurl": "https://www.ivi.ru/watch/2476?utm_source=yandex",
        "[tvDeeplink](*tvDeeplink)": "ivi://movie?uid=f54ab672-ebc8-4753-8461-c83422683d7d&type=movie&action=play",
        "thumbnail": "https://thumbs.dfs.ivi.ru/storage30/contents/a/f/eaf144f2c975420a648ec0a55a0b31.jpg",
        "poster": "",
        "horizontalPoster": "",
        "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
        "watchPeriodEndDate": "2022-10-31T20:59:59.00Z",
        "region": "RU",
        "duration": 9000,
        "quality": "FullHD",
        "embedUrl": "https://www.ivi.ru/player/video/?id=145062",
        "tracks": ["Russian", "Russian 5.1", "English", "English 5.1"],
        "subtitles": ["Russian", "English"],
        "voiceActing": "",
        "restrictionAge": 18,
        "rightHolderLogo": "",
        "contentType": "Film",
        "[monetizationModel](*monetizationModel)": "SVOD",
        "requiresPayment": [
    {
        "price": 399,
        "currency": "RUB",
        "legalUrl": ""
    }
  ]
}

Parameter descriptions

Key	Value	Data type	Required for creating a feed
`title`	Title of the movie or series in Russian.	String	Yes
`kpId`	Object identifier in the Kinopoisk library (required to display the movie or series rating in the answer). Example: for “Inception”, available at `https://www.kinopoisk.ru/film/447301` you have to specify `"kpId":"447301"`.	String	Yes
`url`	Link to the page for viewing the object using the service.	String	Yes
`addurl`	Additional link to the viewing page for tracking traffic coming from the search results.	String	No
`tvDeeplink`	Link to the page for viewing in the app on the TV.	String	No
`poster`	Link to a vertical image. The image should contain the movie title. Size: 1,000 x 1,500 pixels. Formats: PNG, IMG.	String	No
`horizontalPoster`	Link to a horizontal image. The image should contain the movie title. Size: at least 672 x 378 pixels. Formats: PNG, IMG.	String	No
`thumbnail`	Link to a horizontal image. The image should not contain the movie title. It can be key art or a frame from the movie. Size: at least 672 x 378 pixels. Formats: PNG, IMG.	String	Yes
`watchPeriodStartDate`	Date and time when viewing rights are granted. Format: ISO 8601 UTC. If the data is missing, the content is considered available without time restrictions.	String	No
`showStartDate`	Show the date and time when viewing rights were granted. Possible values: `true`; `false`. The default value is `true`.	Boolean	No
`watchPeriodEndDate`	Date and time when viewing rights expire. Format: ISO 8601 UTC. If the data is missing, the content is considered available without time restrictions.	String	No
`region`	Region where the object is available for viewing using this service. Format: two-letter code in ISO 3166 format. Possible values: “RU”.	String	Yes
`disallowedRegions`	Array of regions where showing this piece of content is prohibited due to copyrights. Format: enter the region names in English in any format, separating them by commas.	Array	No
`duration`	Movie duration in seconds.	Number	No
`quality`	Video resolution. Possible values: SD, HD, FullHD, UltraHD, 4K.	String	Yes
`embedUrl`	Embed link to the player that will be embedded on the search query page. If it is not possible to embed the player in the search results, you have to specify value `null` in this field.	String	No (for SVOD, TVOD, or EST) Yes (for AVOD)
`tracks`	Array with available audio tracks. Elements are strings specified in the language of the region.	Array	No
`subtitles`	Array of available subtitle options. Elements are strings specified in the language of the region.	Array	No
`voiceActing`	Name of the dubbing studio. Specified in the language of the region.	String	No
`restrictionAge`	Age restrictions from distribution certificates. You must specify a number (minimum age for viewing). Default value: 18.	Number	No
`rightHolderLogo`	Copyright holder’s logo. Size: 24 x 24 pixels. Format: link to an SVG file.	String	No
`contentType`	Content type. Possible values: Film, Series.	String	Yes
`monetizationModel`	Monetization model. Possible values: SVOD — Subscription Video on Demand. The user subscribes to the service. TVOD — Transactional Video on Demand. The user rents a content unit for a period of time. EST — Electronic Sell-Through. The user purchases a content unit. AVOD — Advertising Video on Demand. The user watches videos with ads that are shown at certain intervals.	String	Yes
`requiresPayment`	Array of data with conditions for purchase, rental, or subscription to the object. For objects with the AVOD monetization model, specify `null`.	Array	Yes
`requiresPayment.name`	Name of the subscription that includes this object. Only for objects with the SVOD monetization model.	String	No
`requiresPayment.legalUrl`	Link to the user agreement on subscription, purchase, or rental terms and conditions.	String	Yes
`requiresPayment.price`	Purchase/rental price or subscription cost for one month. For series — the total price for the purchase of available seasons (from the availableSeasons field) for this monetization model. Note The price must strictly correspond to the monetization model. Indicate the price without taking into account promotions and special offers for specific user groups. Do not calculate the price as a part of the cost of purchasing a subscription for a longer period.	Number	Yes (purchase or rental price) No (subscription cost)
`requiresPayment.currency`	Currency in which the cost of the object is indicated for the selected region.	String	Yes

A TV series object in the "items" array

A content object contains basic information about a movie or TV series with a specific monetization model (like subscription or purchase) for a specific distribution region.

Warning

If a series uses multiple monetization models, (for example, some episodes are available via AVOD and others via SVOD), then submit two TV series objects. They should differ in their monetization model and the array of available seasons and episodes.

Place TV series objects in the items array.

Note

All combinations of the kpId, monetizationModel, and region attribute values must be unique across the file.

TV series object

The TV series structure is an array of seasons.

{
  {
  "title": "Pishcheblok",
  "kpId": "1405843",
  "url": "https://hd.kinopoisk.ru/film/4385d995088540caad8e530cc25f8a2d",
  "addurl": "https://hd.kinopoisk.ru/?rt=4385d995088540caad8e530cc25f8a2d&utm_source=yandex",
  "[tvDeeplink](*tvDeeplink)": "kpatv://film/?filmId=400064e37cf78207a3d89e4ed4d1941f",
  "thumbnail": "https://avatars.mds.yandex.net/get-ott/2439731/2a0000017924346c15443939df21fb1eb3d0/orig",
  "poster": "https://avatars.mds.yandex.net/get-ott/374297/2a0000017981502594a46c1c4e3d63f1792a/orig",
  "horizontalPoster": "https://avatars.mds.yandex.net/get-ott/224348/2a0000017981506683f4bbe2718aa6b01aa7/orig",
  "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
  "watchPeriodEndDate": "2022-12-29T20:59:59.00Z",
  "region": "RU",
  "quality": "FullHD",
  "tracks": ["Russian", "Russian 5.1", "English", "English 5.1"],
  "subtitles": ["Russian", "English"],
  "voiceActing": "Kubik v kube",
  "embedUrl": null,
  "restrictionAge": 18,
  "rightHolderLogo": "",
  "contentType": "Series",
  "[monetizationModel](*monetizationModel)": "SVOD",
  "requiresPayment": [
    {
      "name": "Plus",
      "price": 399,
      "currency": "RUB",
      "legalUrl": ""
    }
  ],
  "availableSeasons": [
    1
  ],
  "seriesStruct": [
    {
      "season": 1,
      "url": "https://hd.kinopoisk.ru/film/4385d995088540caad8e530cc25f8a2d?season=1",
      "[tvDeeplink](*tvDeeplink)": "kpatv://film/?filmId=400064e37cf78207a3d89e4ed4d1941f&season=1",
      "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
      "watchPeriodEndDate": "2022-12-29T20:59:59.00Z",
      "episodes": [
        {
          "episode": 1,
          "url": "https://hd.kinopoisk.ru/film/4385d995088540caad8e530cc25f8a2d?episode=1&season=1",
          "[tvDeeplink](*tvDeeplink)": "kpatv://film/?filmId=400064e37cf78207a3d89e4ed4d1941f&episode=1&season=1",
          "thumbnail": "",
          "title": "Winter is coming",
          "episodes.duration": 2520,
          "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
          "watchPeriodEndDate": "2022-12-29T20:59:59.00Z",
          "embedUrl": "..."
        },
        {
          "episode": 2,
          "url": "https://hd.kinopoisk.ru/film/4385d995088540caad8e530cc25f8a2d?episode=2&season=1",
          "[tvDeeplink](*tvDeeplink)": "kpatv://film/?filmId=400064e37cf78207a3d89e4ed4d1941f&episode=2&season=1",
          "thumbnail": "",
          "title": "Strike Back",
          "episodes.duration": 2720,
          "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
          "watchPeriodEndDate": "2022-12-29T20:59:59.00Z",
          "embedUrl": "..."
        }
      ]
    }
  ]
}

Parameter descriptions

Key	Value	Data type	Required for creating a feed
`title`	Title of the movie or series in Russian.	String	Yes
`kpId`	Object identifier in the Kinopoisk library (required to display the movie or series rating in the answer). Example: for “Inception”, available at `https://www.kinopoisk.ru/film/447301` you have to specify `"kpId":"447301"`.	String	Yes
`url`	Link to the page for viewing the object using the service.	String	Yes
`addurl`	Additional link to the viewing page for tracking traffic coming from the search results.	String	No
`thumbnail`	Link to a horizontal image. The image should not contain the movie title. It can be key art or a frame from the movie. Size: at least 672 x 378 pixels. Formats: PNG, IMG.	String	Yes
`tvDeeplink`	Link to the page for viewing in the app on the TV.	String	No
`poster`	Link to a vertical image. The image should contain the movie title. Size: 1,000 x 1,500 pixels. Formats: PNG, IMG.	String	No
`horizontalPoster`	Link to a horizontal image. The image should contain the movie title. Size: at least 672 x 378 pixels. Formats: PNG, IMG.	String	No
`watchPeriodStartDate`	Date and time when viewing rights are granted. Format: ISO 8601 UTC. If the data is missing, the content is considered available without time restrictions.	String	No
`watchPeriodEndDate`	Date and time when viewing rights expire. Format: ISO 8601 UTC. If the data is missing, the content is considered available without time restrictions.	String	No
`region`	Region where the object is available for viewing using this service. Format: two-letter code in ISO 3166 format. Possible values: “RU”.	String	Yes
`disallowedRegions`	Array of regions where showing this piece of content is prohibited due to copyrights. Format: enter the region names in English in any format, separating them by commas.	Array	No
`quality`	Video resolution. Possible values: SD, HD, FullHD, UltraHD, 4K.	String	Yes
`tracks`	Array with available audio tracks. Elements are strings specified in the language of the region.	Array	No
`subtitles`	Array of available subtitle options. Elements are strings specified in the language of the region.	Array	No
`voiceActing`	Name of the dubbing studio. Specified in the language of the region.	String	No
`embedUrl`	Embed link to the player that will be embedded on the search query page. For a TV series object: `null`. Specify a link for the episodes object.	null	No (for SVOD, TVOD, or EST) Yes (for AVOD)
`restrictionAge`	Age restrictions from distribution certificates. You must specify a number (minimum age for viewing). Default value: 18.	Number	No
`rightHolderLogo`	Copyright holder’s logo. Size: 24 x 24 pixels. Format: link to an SVG file.	String	No
`contentType`	Content type. Possible values: Film, Series.	String	Yes
`monetizationModel`	Monetization model. Possible values: SVOD — Subscription Video on Demand. The user subscribes to the service. TVOD — Transactional Video on Demand. The user rents a content unit for a period of time. EST — Electronic Sell-Through. The user purchases a content unit. AVOD — Advertising Video on Demand. The user watches videos with ads that are shown at certain intervals.	String	Yes
`requiresPayment`	Array of data with conditions for purchase, rental, or subscription to the object. For objects with the AVOD monetization model, specify `null`.	Array	Yes
`requiresPayment.name`	Name of the subscription that includes this object. Only for objects with the SVOD monetization model.	String	No
`requiresPayment.legalUrl`	Link to the user agreement on subscription, purchase, or rental terms and conditions.	String	Yes
`requiresPayment.price`	Purchase/rental price or subscription cost for one month. For series — the total price for the purchase of available seasons (from the availableSeasons field) for this monetization model. Note The price must strictly correspond to the monetization model. Indicate the price without taking into account promotions and special offers for specific user groups. Do not calculate the price as a part of the cost of purchasing a subscription for a longer period.	Number	Yes (purchase or rental price) No (subscription cost)
`requiresPayment.currency`	Currency in which the cost of the object is indicated for the selected region.	String	Yes
`availableSeasons`	Array of available season numbers in this monetization model.	Array	Yes
`seriesStruct`	Serial structure in the specified format.	Array of JSON objects	Yes
`season`	Season number. Parameter in seriesStruct.	Number	Yes
`url`	Link to the page with the current season. Parameter in seriesStruct. If there is no separate landing page for seasons, add a link to the main page of the series.	String	Yes
`watchPeriodEndDate`	Date and time when viewing rights are granted. Parameter in seriesStruct. Format: ISO 8601 UTC. If the data is missing, the content is considered available without time restrictions.	Array of JSON objects	No
`watchPeriodEndDate`	Date and time when viewing rights expire. Parameter in seriesStruct. Format: ISO 8601 UTC. If the data is missing, the content is considered available without time restrictions.	Array of JSON objects	No
`requiresPayment`	Array of data with conditions for buying, renting, or subscribing to the specified season if getting it separately is possible under this monetization model.	Array of JSON objects	No
`requiresPayment.name`	Name of the subscription that includes all the listed seasons of the TV series. Only for objects with the SVOD monetization model.	String	No
`requiresPayment.legalUrl`	Link to the user agreement on subscription, purchase, or rental terms and conditions. Required for the requiresPayment array.	String	No
`requiresPayment.price`	Purchase, rental, or subscription cost for the specified season. Required for the requiresPayment array. Note The price must strictly correspond to the monetization model. Indicate the price without taking into account promotions and special offers for specific user groups. Do not calculate the price as a part of the cost of purchasing a subscription for a longer period.	Number	No
`requiresPayment.currency`	Currency in which the cost of the season is indicated for the selected region. Required for the requiresPayment array.	String	No
`seriesStruct.episodes`	Information about episodes of the current season in the form of an episode array.	Array of JSON objects	Yes
`episodes.episode`	Episode number.	Number	Yes
`episodes.url`	Link to the page with the current episode.	String	Yes
`episodes.thumbnail`	Horizontal image, without the title of the series or show. It can be key-art or a frame from the episode. Size: at least 672 x 378 pixels. Format: PNG or IMG.	String	Yes
`episodes.title`	Episode title, if specified (in Russian).	String	No
`episodes.duration`	Episode duration in seconds.	Number	Yes
`episodes.embedUrl`	Embed link to the player that will be embedded on the search query page. If it is not possible to embed the player in the search results, you have to specify value `null` in this field.	String	No (for SVOD, TVOD, or EST) Yes (for AVOD)

Logo requirements

: Contents
The logo must contain only a symbol, or a word or phrase (for short names).

Element positions
The logo should be designed to fit inside a square and a circle, including the logo's clear space and margins of 12% or more. Grid overflow is allowed if it's part of the brand style and doesn't hinder recognizing the symbol.

Degree of details
The logo must have a neat look and be easily recognizable in small sizes. Fine details, shadows, textures, and effects adding volume are not allowed.

Shape
Fitting other shapes inside the logo is not allowed.

Color
You can use white, black, and no more than two other colors and their gradients. Patterns are not allowed.

Format
Format: SVG, completely filled with color, without alpha channels and without rounded corners.

Size: up to 10 MB.

Conditions for display

The site must ensure that the data is correct and the offers match the subject. It is also responsible for dissemination of illegal information. In the event the terms are violated, Yandex has the right not to use the site data for changing the display in the search results.

To become a partner, submit a request and the file you prepared via the form below.

Submit a request

Page updated: September 19, 2025.

Change history

Expanded the Eligible sites list.
Added a definition for "streaming services".
Added a definition for "online media".

Subscribe to updates

You can also go to

Movies and TV series

Eligible sites

What it adds to search results

How to set it up

Conditions for display

Was the article helpful?