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: 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. 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#
                  ya: http://webmaster.yandex.ru/vocabularies/">
                 <!--Enter 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 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" 
            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 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 using one of these methods:

    • Put the player on a separate page and allow the video to play in Yandex search results. Just add the ya:ovs:allow_embed element with the value true.

      <meta property="og:url" content="//mysite.com/r5cia8fb8q.4708/"/>
      <meta property="ya:ovs:allow_embed" content="true"/>
    • Send the HTML code to integrate 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>"/>

    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).

      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 — HTML code for embedding video player.

      • 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 (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

      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.

      Paid video access

      Supported characteristics:

      • ya:ovs:price:rate — Video price (corresponding to payment type).

      • ya:ovs:price — Video payment type.

        Supported values:

        • rent— Access to the videoclip for a given period of time

        • subscription — Subscription to a series of clips, or for longer access period

        • purchase — Purchase of video

        • currency — Currency in ISO 4217 format.

        • duration — duration (length of paid access) in ISO 8601 format.

      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: 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. 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:embed_html

      String

      HTML code for embedding the player to display the video.

      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:price

      Enum

      Video payment type.

      ya:ovs:price:duration

      DateTime

      Payment duration (length of paid access) in ISO 8601 format.

      ya:ovs:price:rate

      Integer

      Video price (corresponding to payment type in ya:ovs:price field).
      ya:ovs:price:currency

      String

      The currency that the price of the video is specified in (in ISO 4217 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#
                   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 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" 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"/>
      
      <!--Дополнительные поля-->
        <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" 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="Ivan Ivanov"/> 
        <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"/>