Open Graph markup for video

Minimal markup example

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

Property

Type

Description

og:title

String

Video title.

Maximum length is 1000 characters, and longer text is cut off.

og:url

URL

Canonical path to the page, such as: http://myhost.ru/video.html.

og:video

URL

Path to the video player or file.

og:image

URL

URL of the video preview image.

The maximum size is 352 × 198 pixels.

The recommended size is 564 x 318 pixels.

Allowed formats are JPG, PNG, and GIF.

og:description

String

Description of the video.

The recommended length of the video description is 150-1000 characters.

ya:ovs:upload_date

DateTime

Video upload date in the ISO 8601 format.

ya:ovs:adult

Boolean

Indicates content restricted to viewers age 18+.

To mark the video as adult content, set the value to “yes”. If age restrictions aren't needed, set the value “no”.

video:duration

Integer

Video duration in seconds rounded to the nearest whole number.

og:type

String

Video category.

Some categories might require additional fields for the video description.

og:video:type

String

Available codecs for this video format.

Certain data is necessary for correct indexing of the video. 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#
              ya: http://webmaster.yandex.ru/vocabularies/">
             <!--Specifying the prefixes used-->
<head>
  <meta property="og:title" content="Open Graph for video"/> 
  <meta property="og:url" content="http://mysite.com/view/308/"/> 
  <meta property="og:video" content="//mysite.com/iframe/yacinema/123/"/> 
  <meta property="og:description" content="The Open Graph standard was developed by Facebook. It allows you to control the preview that is generated when a link to a site is published on social media and to send information to other Internet services."/> 
  <meta property="video:duration" content="4878787787"/>
  <meta property="og:image" 
        content="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 search embeds the players of major online platforms that have at least 1000 videos in their catalogs.

For your player to be included in video search results, use one of the following ways to inform the Yandex robot about it:

  • Place the player on a separate page and allow playing videos in the Yandex search results. To do this, add the ya: ovs: allow_embed attribute set to true.

    <meta property="og:url" content="//mysite.com/r5cia8fb8q.4708/"/>
<meta property="ya:ovs:allow_embed" content="true"/>

  • Send the HTML code to embed your player using the ya: ovs: embed_html element.

    <meta property="ya:ovs:embed_html" content="
<object data=&quot;//mysite.com/r5cia8fb8q.4708/&quot; id=&quot;flash&quot; type=&quot;application/x-shockwave-flash&quot; height=&quot;240&quot; width=&quot;320&quot;>
<param value=&quot;always&quot; name=&quot;allowscriptaccess&quot;/>
<param value=&quot;true&quot; name=&quot;allowFullScreen&quot;/>
<param value=&quot;high&quot; name=&quot;quality&quot;/>
<param value=&quot;#000000&quot; name=&quot;bgcolor&quot;/><param value=&quot;true&quot; name=&quot;allowfullscreen&quot;/>
<param value=&quot;playlist=13470&quot; name=&quot;flashvars&quot;/></object>"/>

After you include the player in the markup, contact us through the feedback form. We will test your player and notify you about the results.

Additional markup

The fields listed below aren't required, but they help us to index your videos better and display them for relevant user searches.

Video format

The following fields are supported:

  • og: video: width — The width of the video in pixels.

  • og: video: height — The height of the video 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 less than 360 × 640, bitrate lower than 717 kbps).

    • medium — Average quality (resolution from 360 x 640 to 720 x 1280, bitrate from 717 kbps to 1 Mbps).

    • HD — HD quality (resolution from 720 x 1280 to 1080 x 1920, bitrate from 1 to 2 Mbps).

    • full HD — 1080p quality (resolution higher than 1080 × 1920, bitrate higher than 2 Mbps).

Video categories

Each type of video specified in the og:type field (except the other type) assumes the use of additional fields that describe it.

Film (video.movie)

If the og:type field is set to the value video.movie, the video can be additionally described using the following fields:

  • ovs:original_name — The film title in the producer's language.

  • video:release_date — The release date of the film.

  • ys:ovs:movie:part — Part number, if the film consists of several parts (for example, “Harry Potter and the Deathly Hallows: Part 1”).

Episode of a series (video.episode)

Supported characteristics:

  • ya:ovs:episode (required field) — Episode number.

  • ya:ovs:original_name — The episode title in the producer's language.

  • video:release_date — Date the episode was first broadcast.

  • ya:ovs:season — Season number.

Music video (ya:ovs:music)

Supported characteristics:

  • ya:ovs:track_name (required field) — Name of the track.

  • ya:ovs:album — Name of the album.

Show release (video.tv_show)

Supported characteristics:

  • ya:ovs:episode (required field) — Show release number.

  • video:release_date — Date the show was first broadcast.

  • ya:ovs:season — Season number.

Live broadcast (ya:ovs:broadcast)

Supported characteristics:

  • ya:ovs:start_date (required field) — Date and time the broadcast starts.

  • ya:ovs:end_date — Date and time the broadcast ends (not specified if the record is available by the same link after the broadcast ends).

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:url" content="//mysite.com/r5cia8fb8q.4708/"/>
<meta property="ya:ovs:allow_embed" content="true"/>

  • ya:ovs:embed_html — The HTML code for embedding the player to display the video.

  • og:video:type — Available codecs for this video format.

  • ya:ovs:available_platform — The platform to use for playing the video.

    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 the list 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 conform to the ISO 8601 standard, in the format YYYY-MM-DDTHH:mm:ss+03:00, where:

  • YYYY — year

  • MM — month

  • DD — day

  • HH — hour

  • mm — minute

  • ss — second

  • +03:00 is the time zone (in this case, Moscow time).

If you want to set just the year (for example, as a movie's release date), set it to midnight January 1 in the desired year, such as 2001-01-01T00:00:00.

Example markup:

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

Statistics

Views and ratings statistics can be described in the following elements:

  • ya:ovs:views_last_day — Number of views for the last day.

  • ya:ovs:views_last_month is the number of visits in the last month.

  • ya:ovs:views_last_week — Number of views for the last week.

  • ya:ovs:views_total — Total number of views.

  • ya:ovs:comments — Total number of comments on the video.

  • ya:ovs:likes — Total number of users who liked the video.

  • ya:ovs:dislikes — Total number of users who disliked the video.

  • ya:ovs:rating — Average rating of the video (from 0 to 10).

Example markup:

<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"/>

Showing restrictions

Showing restrictions are set with the og:restrictions tag.

International restrictions

Use the og:restrictions:country:allowed and og:restrictions:country:disallowed elements to specify restrictions on showing the video internationally:

  • 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 specified in the ISO 3166-1 format. Multiple restrictions can be comma-separated or set in separate elements.

Age Limitations

Use the og:restrictions:age element to specify age restrictions for showing the video.

Paid access to the video

Supported characteristics:

  • ya:ovs:price:rate — The price of the video (depending on the payment type).

  • ya:ovs:price — Payment type.

    Supported values:

    • rent — Right to view during a restricted period of time.

    • subscription — Subscription to a series of videos or for a long time period.

    • purchase — Purchasing the video,

    • currency — Currency in the ISO 4217 format.

    • duration — Duration (for payment for a period of time) in the ISO 8601 format.

Properties supported by Yandex video search

Video markup properties handled by the Yandex robot are listed below.

Property

Type

Description

og:title

String

Video title.

Maximum length is 1000 characters, and longer text is cut off.

og:url

URL

Canonical path to the page, such as: http://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. Allowed formats are JPG, PNG, and GIF.

og:description

String

Description of the video.

The recommended length of the video description is from 150 to 1000 characters.

ya:ovs:upload_date

DateTime

Video upload date in the ISO 8601 format.

ya:ovs:adult

Boolean

Indicates content restricted to viewers age 18+.

To mark the video as adult content, set the value to “yes”. If age restrictions aren't needed, set the value “no”.

video:duration

Integer

Video duration in seconds rounded to the nearest whole number.

og:type

String

Video category.

Some categories might require additional fields for the video description.

og:video:type

String

Available codecs for this video format.

Additional Information

ya:ovs:content_id

String

Video ID, which must be unique for each video.

The same video that is published on different pages 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.

Several statuses can be separated by commas or specified in several <meta> tags.

Supported field values:

  • published — Published.

  • blocked.

  • private — Protected by privacy settings.

  • processing — Processed.

  • deleted — Deleted.

ya:ovs:login

String

Name of the user who uploaded the video.

ya:ovs:is_official

Boolean

Indicates whether the video is published on the official site or channel of the producer, performer, or copyright holder.

To indicate that the video is official, set the field to "true". If the ya:ovs:is_official field is not in the feed, Yandex considers the video unofficial.

ya:ovs:license

Enum

The type of license for video content.

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 details, see the Viewing restrictions section.

og:restrictions:country:disallowed

String

A list of countries where showing this video is prohibited or restricted.

For details, see the Viewing restrictions section.

og:restrictions:age

String

Age restrictions for this video.

For details, see the Viewing restrictions section.

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 the 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 less than 360 × 640, bitrate lower than 717 kbps).

  • medium — Average quality (resolution from 360 x 640 to 720 x 1280, bitrate from 717 kbps to 1 Mbps).

  • HD — HD quality (resolution from 720 x 1280 to 1080 x 1920, bitrate from 1 to 2 Mbps).

  • full HD — 1080p quality (resolution higher than 1080 × 1920, bitrate higher than 2 Mbps).

ya:ovs:allow_embed

Boolean

Indicates whether the video can be displayed on the Yandex search results page.

By default, a video can be played directly in the search results. To make the video viewable only on your site, set the field as follows:
<meta property="ya:ovs:allow_embed" content="false"/>

ya:ovs:embed_html

String

HTML code for embedding the player to display the video.

ya:ovs:content_url

URL

URL of the video file.

Any 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 allow the Yandex robot to download the file.

ya:ovs:content_url:public

Boolean

Indicates a public video.

Acceptable values:

  • true — The 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 specify several genres separated with commas or put them in separate genre elements. Lists of popular genres can be found in Wikipedia articles dedicated to film genres and music genres.

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 the ISO 639-1 format.

ya:ovs:dubbing

String

Name of the dubbing studio.

ya:ovs:subtitle

URL

URL of the subtitle file in a certain language.

ya:ovs:subtitle:language

String

Language of the subtitles in the ISO 639-1 format.

ya:ovs:price

Enum

Type of payment for the video.

ya:ovs:price:duration

DateTime

Duration (if paid for a period of time) in the ISO 8601 format.

ya:ovs:price:rate

Integer

Price of the video (depending on the payment type in the ya:ovs:price field).

ya:ovs:price:currency

String

The currency in which the video cost is specified (in the ISO 4217 format).

ya:ovs:feed_url

URL

The URL for getting current metadata about the video.

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 views of the video over 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 views of the video over the past week.

ya:ovs:views_total

Integer

Total number of views of the video.

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:person:role

String

A participant in the video, indicating the role in creating the video.

Specify who this person is — an actor, director, producer, performer, or other.

ya:ovs:production_coumpany

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 specified in the ISO 3166-1 format.

ya:ovs:poster

URL

Link to an image of the album cover, movie poster, and so on.

You can specify several images 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 the ISO 8601 format.

ya:ovs:modify_date

DateTime

Date the video was changed, in the ISO 8601 format.

ya:ovs:expiration_date

DateTime

Date the rights to video content expire, in the ISO 8601 format.

Omit it if the rights to the video do not expire.

Example of a detailed video description

<!--Required fields-->
<html prefix="og: http://ogp.me/ns#
             video: http://ogp.me/ns/video#
             ya: http://webmaster.yandex.ru/vocabularies/">
 <head>
  ...
  <meta property="og:title" content="What is schema.org?"/>
  <meta property="ya:ovs:id" content="3543"/>
  <meta property="og:url" content="http://mysite.com/view/308/"/>
  <meta property="og:description" content="Schema.org is a standard for semantic data markup on the web. It was introduced by the Google, Bing, and Yahoo! search engines in the summer of 2011. Semantic markup serves to make the internet more comprehensible and structured, enabling search engines and dedicated software to easily extract and process information for user-friendly display in search results."/>
  <meta property="video:duration" content="4878787787"/>
  <meta property="og:image" content="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"/>

<!--Additional fields-->
  <meta property="ya:ovs:status" content="published"/>
  <meta property="ya:ovs:login" content="john1"/>
  <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" content="//mysite.com/iframe/yacinema/123/"/>
  <meta property="ya:ovs:embed_html" content="
   <object data=&quot;//mysite.com/r5cia8fb8q.4708/&quot; id=&quot;flash&quot;
    type=&quot;application/x-shockwave-flash&quot; height=&quot;240&quot; width=&quot;320&quot;/>
   <param value=&quot;always&quot; name=&quot;allowscriptaccess&quot;/>
   <param value=&quot;true&quot; name=&quot;allowFullScreen&quot;/>
   <param value=&quot;high&quot; name=&quot;quality&quot;/>
   <param value=&quot;#000000&quot; name=&quot;bgcolor&quot;/><param value=&quot;true&quot; 
    name=&quot;allowfullscreen&quot;/>
   <param value=&quot;playlist=13470&quot; name=&quot;flashvars&quot;/></object>"/>
  <meta property="ya:ovs:content_url" content="http://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" content="http://mysite.com/r5cia8fb8q.4708/sdf.str"/>
  <meta property="ya:ovs:subtitle:language" content="ru"/>
  <meta property="ya:ovs:price" content="rent"/>
  <meta property="ya:ovs:price:duration" content="P1DT12H"/>
  <meta property="ya:ovs:price:rate" content="50"/>
  <meta property="ya:ovs:price:currency" content="rur"/>
  <meta property="ya:ovs:feed_url" content="http://example.com/user111/view24/view24.xml"/>
  <meta property="ya:ovs:price:currency" content="rur"/>
  <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="John Smith"/> 
  <meta property="ya:ovs:person:role" content="director"/>
  <meta property="ya:ovs:person" content="Jane Doe"/> 
  <meta property="ya:ovs:person:role" content="host"/>
  <meta property="ya:ovs:production_company" content="yandes"/> 
  <meta property="ya:ovs:country" content="Ru"/> 
  <meta property="ya:ovs:poster" 
   content="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"/>
Contact Support



You can also go to