Open Graph video markup

Example of minimal markup

All video markup properties that are processed by the Yandex robot are listed below.


Property	Type	Description
og:title	String	Video title. Maximum length is 1000 characters; longer text is cut off.
og:url	URL	Canonical path to the page, for example: https://myhost.ru/video.html.
og:video	URL	Path to the video player or file.
og:image	URL	URL of the video preview image. Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF.
og:description	String	Video description. The recommended length of the video description is 150-1000 characters.
ya:ovs:upload_date	DateTime	Date the video was uploaded, in ISO 8601 format.
ya:ovs:adult	Boolean	Indicates content restricted to viewers age 18+. To mark the video as adult content, enter “true”. If there are no age restrictions, enter “false”.
video:duration	Integer	Video length in seconds rounded to the nearest integer.
og:type	String	Video category. Some categories may require additional fields for the video description.
og:video:type	String	Available codecs for this video format.


Property	Type	Description
og:title	String	Video title. Maximum length is 1000 characters; longer text is cut off.
og:url	URL	Canonical path to the page, for example: https://myhost.ru/video.html.
og:video	URL	Path to the video player or file.
og:image	URL	URL of the video preview image. Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF.
og:description	String	Video description. The recommended length of the video description is 150-1000 characters.
ya:ovs:upload_date	DateTime	Date the video was uploaded, in ISO 8601 format.
ya:ovs:adult	Boolean	Indicates content restricted to viewers age 18+. To mark the video as adult content, enter “true”. If there are no age restrictions, enter “false”.
video:duration	Integer	Video length in seconds rounded to the nearest integer.
og:type	String	Video category. Some categories may require additional fields for the video description.
og:video:type	String	Available codecs for this video format.

Certain data is necessary to correctly index the videoclips. A minimal video description in Open Graph markup might look like this:

<html prefix="og: http://ogp.me/ns#
              video: http://ogp.me/ns/video#">

<!--Enter prefixes used-->
<head>
  <meta property="og:title" content="Open Graph for video"/> 
  <meta property="og:url" href="https://www.mysite.com/view/308/"/> 
  <meta property="og:video" href="https://www.mysite.com/iframe/yacinema/123/"/> 
  <meta property="og:description" content="The Open Graph standard was developed by Facebook. It lets you сontrol the preview that is generated when a link is posted on a social networking site and transfers information to other internet services."/> 
  <meta property="video:duration" content="4878787787"/>
  <meta property="og:image" href="http://yandex.st/lego/_/X31pO5JJJKEifJ7sfvuf3mGeD_8.png"/>
  <meta property="ya:ovs:upload_date" content="2013-06-05"/>
  <meta property="ya:ovs:adult" content="false"/>
  <meta property="og:type" content="video.other"/>
  <meta property="og:video:type" content="flash"/>
</head>

Adding a player

Note. Currently Yandex.Video has embedded players for the major hosting sites (those that have a base of at least 1000 videoclips).

To make sure your player ends up in video search results, let the Yandex robot know about it:

Put the player on a separate page.

Allow the video to play in Yandex search results. Just add the ya:ovs:allow_embed element with the value true.

<meta property="og:video" href="https://www.mysite.com/iframe/yacinema/123/"/>
<meta property="ya:ovs:allow_embed" content="true"/>

Use the feedback form to let us know when you enter the player information in the markup. We will test the player and inform you of the results.

Additional markup

The fields listed below are not mandatory, but including them will help with indexing your videoclips and will increase the odds that your videos will display in response to a relevant search query.

Video format

The following fields are supported:

og:video:width— Video width in pixels.
og:video:height — Video height in pixels.
ya:ovs:bitrate — Maximum bitrate in kilobits per second (kbps).
ya:ovs:quality — Quality of video encoding.

Supported values:
- low — Low quality (resolution lower than 360×640, bitrate below 717 kbps)
- medium — Average quality (resolution between 360×640 and 720×1280, bitrate from 717 kbps to 1 Mbps)
- HD — HD quality (resolution between 720×1280 and 1080×1920, bitrate of 1-2 Mbps)
- full HD — 1080 res quality (resolution higher than 1080×1920, bitrate above 2 Mbps).

Video categories

Additional fields that provide further information should be entered for each type of video listed in the og:type field (with the exception of type other).

Movie (video.movie)

If the video.movie value is entered for the og:type element, then the video can be further described using the following fields:

ya:ovs:original_name — Name of film in original language.
video:release_date— Movie release date.
ys:ovs:movie:part — Part number (for movies with multiple parts, such as “Harry Potter and the Deathly Hollows: Part 1”).

Episode of a series (video.episode)

Supported characteristics:

ya:ovs:episode (mandatory field) — Episode number.
ya:ovs:original_name — Name of film in original language.
video:release_date — Series release date.
ya:ovs:season — Season number.

Music video (ya:ovs:music)

Supported characteristics:

ya:ovs:track_name (mandatory field) — Track name.
ya:ovs:album— Album name.

Episode of a show (video.tv_show)

Supported characteristics:

ya:ovs:episode (mandatory field) — TV show episode number.
video:release_date — Date show was first broadcast.
ya:ovs:season — Which season the episode is part of.

Broadcast (ya:ovs:broadcast)

Supported characteristics:

ya:ovs:start_date (mandatory field) — Date and time at start of broadcast.
ya:ovs:end_date — Date and time at end of broadcast (don't enter if the video is available at the same address as the last broadcast.)

Video player parameters

Supported characteristics:

ya:ovs:allow_embed — Indicates that the video can be displayed on the Yandex search results page.

<meta property="og:video" href="https://www.mysite.com/iframe/yacinema/123/"/>
<meta property="ya:ovs:allow_embed" content="true"/>

og:video:type — Available codecs for this video format.
ya:ovs:available_platform — Platforms you can play video on.

Sample list of supported platforms:
```
<meta property="ya:ovs:available_platform" content="Windows"/>
<meta property="ya:ovs:available_platform" content="WindowsPhone"/>
```
Full list of supported values
- Desktop — indicates that the main PC platforms are supported (listed below)
- Windows
- Linux
- OSX
- Mobile — Indicates that the main mobile platforms are supported (listed below)
- iOS
- Android
- WindowsPhone
- WindowsMobile
- Symbian
- Bada
- BlackBerry
- MeeGo

Date format

Date and time should be entered using the ISO 8601 standard in the YYYY-MM-DDTHH:mm:ss+03:00 format, where:

YYYY — year
MM — month
DD — day
HH — hour
mm — minute
ss — second
+03:00 — time zone (in this case — Moscow time).

If you want to set just the year (for example, for a movie release date), set it to midnight on January 1 of that year, for example 2001-01-01T00:00:00.

Markup example:

<meta property="ya:ovs:upload_date" content="2013-06-05T06:15:00"/>

Statistics

Viewing and rating statistics for the video can be entered using the following elements:

ya:ovs:views_last_day — number of video viewings in the past day.
ya:ovs:views_last_month — number of video viewings in the past month.
ya:ovs:views_last_week — number of video viewings in the past week.
ya:ovs:views_total — total number of video viewings.
ya:ovs:comments — total number of video comments.
ya:ovs:likes — total number of users who "liked" the video.
ya:ovs:dislikes — total number of users who didn't like the video.
ya:ovs:rating — average video rating (on a scale from 0 to 10).

Markup example:

<meta property="ya:ovs:views_last_day" content="5"/>
<meta property="ya:ovs:views_last_month" content="555"/>
<meta property="ya:ovs:views_last_week" content="25"/>
<meta property="ya:ovs:views_total" content="78787"/> 
<meta property="ya:ovs:comments" content="23"/> 
<meta property="ya:ovs:likes" content="78782"/> 
<meta property="ya:ovs:dislikes" content="5"/> 
<meta property="ya:ovs:rating" content="9"/>

Viewing restrictions

Video restrictions are entered using the og:restrictions tag.

International restrictions

You can use the og:restrictions:country:allowed and og:restrictions:country:disallowed elements to enter restrictions regarding where the video can be shown.

We recommend using the og:restrictions:country:allowed element if the video is only allowed to be shown in certain countries.
We recommend using the og:restrictions:country:disallowed element if the video is only restricted in a few countries. Using these two elements together will cause an error.

Countries should be listed using the ISO 3166-1 format. Multiple restrictions can be comma-separated or set in separate elements.

Age restrictions

Use the og:restrictions:age element to specify any age restriction.

Properties that Yandex.Video supports

All video markup properties that are processed by the Yandex robot are listed below.


Property	Type	Description
Mandatory
og:title	String	Video title. Maximum length is 1000 characters; longer text is cut off.
og:url	URL	Canonical path to the page, for example: https://myhost.ru/video.html.
og:video	URL	Path to the video player or file.
og:image	URL	URL of the video preview image. Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF.
og:description	String	Video description. The recommended length of the video description is from 150 to 1000 characters.
ya:ovs:upload_date	DateTime	Date the video was uploaded, in ISO 8601 format.
ya:ovs:adult	Boolean	Indicates content restricted to viewers age 18+. To mark the video as adult content, enter “true”. If there are no age restrictions, enter “false”.
video:duration	Integer	Video length in seconds rounded to the nearest integer.
og:type	String	Video category. Some categories may require additional fields for the video description.
og:video:type	String	Available codecs for this video format.
Additional
ya:ovs:content_id	String	Video ID, which must be unique for each video. If the same video is hosted on different pages, it must have the same ID in the markup of those pages. This way the robot can avoid indexing duplicates.
ya:ovs:status	Enum	The current status of the video. Multiple statuses can be comma-separated or set in multiple `<meta>` tags. Supported field values: `published` `blocked` `private` `processing` `deleted`
ya:ovs:login	String	Name of the user who uploaded the video.
ya:ovs:is_official	Boolean	Indicates the video is hosted on the official site or channel of the producer, performer, or copyright holder. To indicate that a video is official, add the is_official element with the value "yes". If the `ya:osvs:is_official` field is not in the feed, Yandex considers the video unofficial.
ya:ovs:license	Enum	Type of video content license. Supported values: “cc” — Creative Commons license “commercial” — commercial license
og:restrictions:country:allowed	String	A list of countries where this video is allowed to be shown. For more details, see Viewing restrictions.
og:restrictions:country:disallowed	String	A list of countries where showing this video is prohibited or restricted. For more details, see Viewing restrictions.
og:restrictions:age	String	Age restrictions for this video. For more details, see Viewing restrictions.
ya:ovs:available_platform	Enum	The platform that this video can be played on. Sample list of supported platforms: `<meta property="ya:ovs:available_platform" content="Windows"/> <meta property="ya:ovs:available_platform" content="WindowsPhone"/>` Full list of supported values: Desktop — indicates that the main PC platforms are supported (see list below) Windows Linux OSX Mobile — Indicates that the main mobile platforms are supported (listed below). iOS Android WindowsPhone WindowsMobile Symbian Bada BlackBerry MeeGo
og:video:width	Integer	Width of the video in pixels.
og:video:height	Integer	Height of the video in pixels.
ya:ovs:bitrate	Integer	Maximum bitrate in kilobits per second (kbps).
ya:ovs:quality	Enum	Quality of video encoding. Supported values: `low` — Low quality (resolution lower than 360×640, bitrate below 717 kbps) `medium` — Average quality (resolution between 360×640 and 720×1280, bitrate from 717 kbps to 1 Mbps) `HD` — HD quality (resolution between 720×1280 and 1080×1920, bitrate of 1-2 Mbps) `full HD` — 1080 res quality (resolution higher than 1080×1920, bitrate above 2 Mbps)
ya:ovs:allow_embed	Boolean	Indicates that the video can be displayed on the Yandex search results page. By default, a video can be played directly in the search results. To restrict the video for viewing only on your site, set the field like this: `<meta property="ya:ovs:allow_embed" content="false"/>`
ya:ovs:content_url	URL	URL of the video file. All video formats are allowed — .mpg, .mpeg, .mp4, .m4v, .mov, .wmv, .asf, .avi, .ra, .ram, .rm, .flv and so on. The Yandex robot must be able to access the video file to retrieve and update supplementary information about the video. If you have closed public access to the file, we recommend using reverse DNS lookup to only allow the Yandex robot to have access.
ya:ovs:content_url:public	Boolean	Indicates a public video. Acceptable values: `true` — Users can download the video file. `false` — Only the search robot can download the video file for automated analysis of the video stream.
ya:ovs:category	String	Video category (“music”, “movie”, “series”, and so on).
ya:ovs:genre	String	Video genre in any form (rock, drama, parody). You can set multiple genres by separating them with commas or putting them in separate `genre` elements. You can find lists of popular genres in Wikipedia articles on film genre or music genre.
video:tag	String	Keywords (tags) related to the video. Tags can be comma-separated or set in separate elements.
ya:ovs:languages	String	A list of languages that the video has soundtracks for. Multiple languages can be comma-separated or set in separate elements. Languages should be set in ISO 639-1 format.
ya:ovs:dubbing	String	Name of the dubbing studio.
ya:ovs:subtitle	URL	Link to the subtitles file for a given language.
ya:ovs:subtitle:language	String	Language of subtitles in ISO 639-1 format.
ya:ovs:feed_url	URL	Address where current video metadata can be found. This may be the same as the address of the video's page, if the semantic markup is detailed enough.
ya:ovs:views_last_day	Integer	The number of video viewings in the past day.
ya:ovs:views_last_month	Integer	The number of views of the video over the past month.
ya:ovs:views_last_week	Integer	The number of video viewings in the past week.
ya:ovs:views_total	Integer	Total number of video viewings.
ya:ovs:comments	Integer	Total number of comments on the video.
ya:ovs:likes	Integer	Total number of users who liked the video.
ya:ovs:dislikes	Integer	Total number of users who did not like the video.
ya:ovs:rating	Integer	Average rating of the video (on a scale from 0 to 10).
ya:ovs:person	String	Name of a person who participated in making the video.
ya:ovs:production_company	String	The company that created the video.
ya:ovs:country	String	The country the video was created in. Multiple countries can be comma-separated or set in separate elements. Countries should be listed using the ISO 3166-1 format.
ya:ovs:poster	URL	Link to an image of the album cover, movie poster, and so on. Multiple images can be set in multiple poster elements. Minimum image size — 256×360. JPG, PNG and GIF formats are supported.
ya:ovs:created_date	DateTime	Date the video was created, in ISO 8601 format.
ya:ovs:modify_date	DateTime	Date the video was changed, in ISO 8601 format.
ya:ovs:expiration_date	DateTime	Date the right to access video content expires, in ISO 8601 format. Omit if access rights do not expire.


Property	Type	Description
Mandatory
og:title	String	Video title. Maximum length is 1000 characters; longer text is cut off.
og:url	URL	Canonical path to the page, for example: https://myhost.ru/video.html.
og:video	URL	Path to the video player or file.
og:image	URL	URL of the video preview image. Minimum size is 120x90 pixels. Permitted formats are JPG, PNG, and GIF.
og:description	String	Video description. The recommended length of the video description is from 150 to 1000 characters.
ya:ovs:upload_date	DateTime	Date the video was uploaded, in ISO 8601 format.
ya:ovs:adult	Boolean	Indicates content restricted to viewers age 18+. To mark the video as adult content, enter “true”. If there are no age restrictions, enter “false”.
video:duration	Integer	Video length in seconds rounded to the nearest integer.
og:type	String	Video category. Some categories may require additional fields for the video description.
og:video:type	String	Available codecs for this video format.
Additional
ya:ovs:content_id	String	Video ID, which must be unique for each video. If the same video is hosted on different pages, it must have the same ID in the markup of those pages. This way the robot can avoid indexing duplicates.
ya:ovs:status	Enum	The current status of the video. Multiple statuses can be comma-separated or set in multiple `<meta>` tags. Supported field values: `published` `blocked` `private` `processing` `deleted`
ya:ovs:login	String	Name of the user who uploaded the video.
ya:ovs:is_official	Boolean	Indicates the video is hosted on the official site or channel of the producer, performer, or copyright holder. To indicate that a video is official, add the is_official element with the value "yes". If the `ya:osvs:is_official` field is not in the feed, Yandex considers the video unofficial.
ya:ovs:license	Enum	Type of video content license. Supported values: “cc” — Creative Commons license “commercial” — commercial license
og:restrictions:country:allowed	String	A list of countries where this video is allowed to be shown. For more details, see Viewing restrictions.
og:restrictions:country:disallowed	String	A list of countries where showing this video is prohibited or restricted. For more details, see Viewing restrictions.
og:restrictions:age	String	Age restrictions for this video. For more details, see Viewing restrictions.
ya:ovs:available_platform	Enum	The platform that this video can be played on. Sample list of supported platforms: `<meta property="ya:ovs:available_platform" content="Windows"/> <meta property="ya:ovs:available_platform" content="WindowsPhone"/>` Full list of supported values: Desktop — indicates that the main PC platforms are supported (see list below) Windows Linux OSX Mobile — Indicates that the main mobile platforms are supported (listed below). iOS Android WindowsPhone WindowsMobile Symbian Bada BlackBerry MeeGo
og:video:width	Integer	Width of the video in pixels.
og:video:height	Integer	Height of the video in pixels.
ya:ovs:bitrate	Integer	Maximum bitrate in kilobits per second (kbps).
ya:ovs:quality	Enum	Quality of video encoding. Supported values: `low` — Low quality (resolution lower than 360×640, bitrate below 717 kbps) `medium` — Average quality (resolution between 360×640 and 720×1280, bitrate from 717 kbps to 1 Mbps) `HD` — HD quality (resolution between 720×1280 and 1080×1920, bitrate of 1-2 Mbps) `full HD` — 1080 res quality (resolution higher than 1080×1920, bitrate above 2 Mbps)
ya:ovs:allow_embed	Boolean	Indicates that the video can be displayed on the Yandex search results page. By default, a video can be played directly in the search results. To restrict the video for viewing only on your site, set the field like this: `<meta property="ya:ovs:allow_embed" content="false"/>`
ya:ovs:content_url	URL	URL of the video file. All video formats are allowed — .mpg, .mpeg, .mp4, .m4v, .mov, .wmv, .asf, .avi, .ra, .ram, .rm, .flv and so on. The Yandex robot must be able to access the video file to retrieve and update supplementary information about the video. If you have closed public access to the file, we recommend using reverse DNS lookup to only allow the Yandex robot to have access.
ya:ovs:content_url:public	Boolean	Indicates a public video. Acceptable values: `true` — Users can download the video file. `false` — Only the search robot can download the video file for automated analysis of the video stream.
ya:ovs:category	String	Video category (“music”, “movie”, “series”, and so on).
ya:ovs:genre	String	Video genre in any form (rock, drama, parody). You can set multiple genres by separating them with commas or putting them in separate `genre` elements. You can find lists of popular genres in Wikipedia articles on film genre or music genre.
video:tag	String	Keywords (tags) related to the video. Tags can be comma-separated or set in separate elements.
ya:ovs:languages	String	A list of languages that the video has soundtracks for. Multiple languages can be comma-separated or set in separate elements. Languages should be set in ISO 639-1 format.
ya:ovs:dubbing	String	Name of the dubbing studio.
ya:ovs:subtitle	URL	Link to the subtitles file for a given language.
ya:ovs:subtitle:language	String	Language of subtitles in ISO 639-1 format.
ya:ovs:feed_url	URL	Address where current video metadata can be found. This may be the same as the address of the video's page, if the semantic markup is detailed enough.
ya:ovs:views_last_day	Integer	The number of video viewings in the past day.
ya:ovs:views_last_month	Integer	The number of views of the video over the past month.
ya:ovs:views_last_week	Integer	The number of video viewings in the past week.
ya:ovs:views_total	Integer	Total number of video viewings.
ya:ovs:comments	Integer	Total number of comments on the video.
ya:ovs:likes	Integer	Total number of users who liked the video.
ya:ovs:dislikes	Integer	Total number of users who did not like the video.
ya:ovs:rating	Integer	Average rating of the video (on a scale from 0 to 10).
ya:ovs:person	String	Name of a person who participated in making the video.
ya:ovs:production_company	String	The company that created the video.
ya:ovs:country	String	The country the video was created in. Multiple countries can be comma-separated or set in separate elements. Countries should be listed using the ISO 3166-1 format.
ya:ovs:poster	URL	Link to an image of the album cover, movie poster, and so on. Multiple images can be set in multiple poster elements. Minimum image size — 256×360. JPG, PNG and GIF formats are supported.
ya:ovs:created_date	DateTime	Date the video was created, in ISO 8601 format.
ya:ovs:modify_date	DateTime	Date the video was changed, in ISO 8601 format.
ya:ovs:expiration_date	DateTime	Date the right to access video content expires, in ISO 8601 format. Omit if access rights do not expire.

Example of detailed video description

<!--Mandatory fields-->
<html prefix="og: http://ogp.me/ns#
              video: http://ogp.me/ns/video#">
 <head>
  ...
  <meta property="og:title" content="What is schema.org"/>
  <meta property="ya:ovs:id" content="3543"/>
  <meta property="og:url" href="https://www.mysite.com/view/308/"/>
  <meta property="og:description" content="Schema.org is a semantic markup standard for internet data that was released by Google, Bing and Yahoo! during the summer of 2011. "The goals of semantic markup are to make the internet more intelligible and structured, and to make it easier for search systems and special programs to retrieve and process information so that it is clearly presented in search results."/>
  <meta property="video:duration" content="4878787787"/>
  <meta property="og:image" href="http://yandex.st/lego/_/X31pO5JJJKEifJ7sfvuf3mGeD_8.png"/>
  <meta property="ya:ovs:upload_date" content="2013-06-05T00:00:00"/>
  <meta property="ya:ovs:adult" content="false"/>
  <meta property="og:type" content="video.other"/>
  <meta property="og:video:type" content="flash"/>

<!--Дополнительные поля-->
  <meta property="ya:ovs:status" content="published"/>
  <meta property="ya:ovs:login" content="ivan1"/>
  <meta property="ya:ovs:is_official" content="true"/>
  <meta property="ya:ovs:license" content="cc"/>
  <meta property="og:restrictions:country:allowed" content="Ru, Ua, Us, Uk"/>
  <meta property="ya:ovs:available_platform" content="Desktop"/>
  <meta property="og:video:width" content="350"/>
  <meta property="og:video:height" content="700"/>
  <meta property="ya:ovs:bitrate" content="254"/>
  <meta property="ya:ovs:quality" content="low"/>
  <meta property="ya:ovs:allow_embed" content="true"/>
  <meta property="og:video" href="https://www.mysite.com/iframe/yacinema/123/"/>
  
  <meta property="ya:ovs:content_url" href="https://www.mysite.com/r5cia8fb8q.4708/111.swf"/>
  <meta property="ya:ovs:content_url:public" content="true"/>
  <meta property="ya:ovs:category" content="education"/>
  <meta property="ya:ovs:genre" content="technology"/>
  <meta property="video:tag" content="technology"/>
  <meta property="video:tag" content="schema.org"/>
  <meta property="ya:ovs:languages" content="ru"/>
  <meta property="ya:ovs:subtitle" href="https://www.mysite.com/r5cia8fb8q.4708/sdf.str"/>
  <meta property="ya:ovs:subtitle:language" content="ru"/>
  <meta property="ya:ovs:feed_url" href="https://example.com/user111/view24/view24.xml"/>
  <meta property="ya:ovs:views_last_day" content="5"/>
  <meta property="ya:ovs:views_last_month" content="555"/>
  <meta property="ya:ovs:views_last_week" content="25"/>
  <meta property="ya:ovs:views_total" content="78787"/> 
  <meta property="ya:ovs:comments" content="23"/> 
  <meta property="ya:ovs:likes" content="78782"/> 
  <meta property="ya:ovs:dislikes" content="5"/> 
  <meta property="ya:ovs:rating" content="9"/> 
  <meta property="ya:ovs:person" content="Ivan Ivanov"/> 
  <meta property="ya:ovs:production_company" content="yandes"/> 
  <meta property="ya:ovs:country" content="Ru"/> 
  <meta property="ya:ovs:poster" href="http://yandex.st/lego/_/X31pO5JJJKEifJ7sfvuf3mGeD_8.png"/>
  <meta property="ya:ovs:created_date" content="2012-11-08T00:00:00"/> 
  <meta property="ya:ovs:modify_date" content="2013-06-05T00:00:00"/> 
  <meta property="ya:ovs:expiration_date" content="2023-06-05T00:00:00"/>