SearchMonkey > Start Overview > Video

Video - A clip or other video

Example

YouTube - Irish dancing monkeys

Monkeys can also dance. And the music they prefer is Irish Step!

  • www.youtube.com/watch?v=44Y-_JAjAwE
  • 101k
Video thumbnail Play Video

Description

Play videos directly in Yahoo! Search. Add code to indicate to Yahoo! that a video exists on your page, and when we next crawl your site, we'll take care of the rest. From your markup, we’ll be able to extract structured data from your site and render it automatically in an enhanced result in search results.

Details

  • Types of video permitted: The Yahoo! Search video player currently supports Flash video only. Yahoo! is committed to delivering high-quality, relevant search results. Do not mark up content that is inappropriate, misleading, or violates any applicable laws.
  • Supported streaming Flash players include: Hulu, YouTube, Yahoo! Video, and Metacafe
  • New video players: Your enhanced result will only appear if you are currently using a pre-approved player or if your player is subsequently reviewed and approved for display. Not sure if your player is already approved? Search on Yahoo! Search with the "site:<domain>" keyword plus 1-2 other search query terms. For example: site:metacafe.com cute puppies. If an enhanced result does not appear, please complete the player submission form to request approval.
  • How soon after I add my markup will I see my enhanced result appear? Assuming you are using a pre-existing approved player or have had your new player approved, your enhanced result will appear after Yahoo! recrawls your page; this can take between a few days and a few weeks depending on your site.

Get Started

1. Use an approved player

See "Details" section above

2. Add code / markup to your site

Copy this code and replace the example text with your data to see an enhanced video display in Yahoo! Search.

  • Use RDFa markup to allow embedding your videos on third-party sites and to use extra features such as region restrictions.
  • Use Facebook Share markup for the simplest possible way to display your video in Yahoo! Search.
  • Use DataRSS XML to send your data to Yahoo! privately, using a feed. Once you have constructed your DataRSS feed, you must submit the feed to Yahoo!.

RDFa

Required

Click any item to toggle description on or off

xmlns:media(url)
The SearchMonkey Media namespace. Format: A valid URL. The only acceptable value is "http://search.yahoo.com/searchmonkey/media/".
media:thumbnail(gif, jpg, png)
An image that previews the video before the user clicks the "play" button. An image must be paired with a video stream in order for the Yahoo! Search video player to display. Format: A URL to a GIF, PNG, or JPG image. The preview thumbnail must be hosted on the same domain as the video. The image should be 105 x 93 pixels large.
media:video(url)
The video to play when the user clicks the "play" button. A video must be paired with an image in order for the Yahoo! Search video player to display. Format: A URL to a flash video object. The flash video object must be hosted on a domain from the whitelist at the top of this page. By default, the Yahoo! Search video player will scale your flash video to 565 x 461 pixels. You can provide an explicit height and width using media:height and media:width.

Example 1

<object width="512" height="296" rel="media:video"
 resource="http://example.com/video_object.swf"
 xmlns:media="http://search.yahoo.com/searchmonkey/media/">
   <a rel="media:thumbnail" href="http://example.com/thumbnail_preview.jpg" />
   <param name="movie" value="http://example.com/video_object.swf" />
   <embed src="http://example.com/video_object.swf" type="application/x-shockwave-flash" width="512" height="296">
   </embed>
</object>

NOTE: Your video player's embed code might vary.

Recommended

Click any item to toggle description on or off

xmlns:dc(url)
The Dublin Core namespace. This namespace is only required if you are using Dublin Core metadata such as dc:description. NOTE: You may add more namespaces in order to include data from other vocabularies. Format: A valid URL to the Dublin Core namespace. The only acceptable value is "http://purl.org/dc/terms/".
dc:contributor(string)
The full name or username of the person who uploaded the video. Format: A string of up to 60 characters.
dc:creator(string)
The name of the person or organization that created the video. Format: A string of up to 60 characters.
dc:date(date)
A date or timestamp indicating when the video was last uploaded or modified. Format: A date or timestamp, as defined by http://www.w3.org/TR/NOTE-datetime.
dc:description(string)
A short description of the video. Format: A string of up to 200 characters.
dc:identifier(string)
An unambiguous reference to the video, such as the video's unique URL. Format: A string of up to 200 characters.
dc:license(url)
Indicates the license for this content. You may use dc:license or cc:license. If you supply a Creative Commons license URL using cc:license, Yahoo! Search may use this information to help users find content that is in the public domain or under a Creative Commons license. Format: A URL pointing to a human-readable license file.
dc:subject(string)
The video's category or subject. Format: A string of up to 60 characters.
media:duration(integer)
The duration of the video in seconds. Format: An integer.
media:height(integer)
The video's height in pixels, including any "chrome" provided by the third party player. By default, the Yahoo! Search video player scales the object it receives to 565 x 461 pixels. If you provide an explicit height < 461 pixels, Yahoo! Search will confine your video to the specified height. Use this feature to adjust Yahoo!'s aspect ratio from the default. Format: An integer value equal to or less than 461.
media:player(string)
A string identifier for the player used to play the video. Format: A string of up to 60 characters.
media:region(string)
An international region where the video may be played. You may provide multiple media:region fields. Acceptable values include:
ValueRegion
*Play in all regions (default)
nonePlay in no regions
arArgentina - Spanish
auAustralia - English
brBrazil - Portuguese
caCanada - English
clChile - Spanish
coColombia - Spanish
deGermany - German
esSpain - Spanish
frFrance - French
idIndonesia - Bahasa Indonesian
itItalia - Italian
jpJapan - Japanese
mxMexico - Spanish
myMalaysia - English
nzNewZealand - English
pePeru - Spanish
phPhilippines - English
qcQuebec - French
sgSingapore - English
ukUnited Kingdom - English
usUnited States - English
veVenezuela - Spanish
vnVietnam - Vietnamese
Format: A keyword or two-character region code.
  • the keyword "*": play in all regions. If media:region is not present, the value is assumed to be *.
  • the keyword "none": play in no regions. This overrides all other media:regions that might be specified.
  • an intl such as "uk": play in the specified region. This overrides a media:region of *. You may provide multiple media:regions.
media:title(string)
The video's title. Format: A string of up to 60 characters.
media:type(mime-type)
The video's MIME-type. Format: A valid MIME-type string. Currently, the only acceptable value is "application/x-shockwave-flash".
media:views(integer)
The number of times the video has been viewed. Format: An integer.
media:width(integer)
The video's width in pixels, including any "chrome" provided by the third party player. By default, the Yahoo! Search video player scales the object it receives to 565 x 461 pixels. If you provide an explicit width < 565 pixels, Yahoo! Search will confine your video to the specified width. Use this feature to adjust Yahoo!'s aspect ratio from the default. Format: An integer value equal to or less than 565.
review:rating(number)
The numeric rating of the video. Ideally, a number from 0 to 5 corresponding to a star rating. Format: A number.

Example 2

<object width="512" height="296" rel="media:video" 
     resource="http://example.com/video_object.swf"
     xmlns:media="http://search.yahoo.com/searchmonkey/media/"
     xmlns:dc="http://purl.org/dc/terms/">
   <param name="movie" value="http://example.com/video_object.swf" />
   <embed src="http://example.com/video_object.swf"
       type="application/x-shockwave-flash" width="512" height="296"></embed>
   <a rel="media:thumbnail" href="http://example.com/thumbnail_preview.jpg" />
   <a rel="dc:license" href="http://example.com/terms_of_service.html" />
   <span property="dc:description" content="Cute Overload defines Baroo? as: Dogspeak for 'Whut the...?' 
       Frequently accompanied by the Canine Tilt and/or wrinkled brow for enhanced effect." />
   <span property="media:title" content="Baroo? - cute puppies" />
   <span property="media:width" content="512" />
   <span property="media:height" content="296" />
   <span property="media:type" content="application/x-shockwave-flash" />
   <span property="media:region" content="us" />
   <span property="media:region" content="uk" />
</object>

You may include even more data than this, such as user information and review information. This metadata will be available in SearchMonkey and Yahoo! Search BOSS for further use. For more information, refer to the RDFa specification or the RDFa wiki.

NOTE: To validate your markup with RDFa attributes, use this W3C DOCTYPE: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML+RDFa 1.0//EN" "http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd">

Facebook Share

Minimum

Click any item to toggle description on or off

image_src(gif, jpg, png)
An image that previews the video before the user clicks the "play" button. An image must be paired with a video stream in order for the Yahoo! Search video player to display. Format: A URL to a GIF, PNG, or JPG image. The preview thumbnail must be hosted on the same domain as the video. The image should be 105 x 93 pixels large.
video_src(url)
The video to play when the user clicks the "play" button. A video must be paired with an image in order for the Yahoo! Search video player to display. Format: A URL to a flash video object. The flash video object must be hosted on a domain from the whitelist at the top of this page. By default, the Yahoo! Search video player will scale your flash video to 565 x 461 pixels. You can provide an explicit height and width using video_height and video_width.

Example 1

<head>
 <link rel="image_src" href="http://example.com/thumbnail_preview.jpg" />
 <link rel="video_src" href="http://example.com/video_object.swf" />
</head>

This is the minimum markup you need to trigger the Yahoo! Search video player on your page when that page turns up in search results.

Recommended

Click any item to toggle description on or off

video_height(integer)
The video's height in pixels, including any "chrome" provided by the third party player. By default, the Yahoo! Search video player scales the object it receives to 565 x 461 pixels. If you provide an explicit height < 461 pixels, Yahoo! Search will confine your video to the specified height. Use this feature to adjust Yahoo!'s aspect ratio from the default. Format: An integer value equal to or less than 461.
video_width(integer)
The video's width in pixels, including any "chrome" provided by the third party player. By default, the Yahoo! Search video player scales the object it receives to 565 x 461 pixels. If you provide an explicit width < 565 pixels, Yahoo! Search will confine your video to the specified width. Use this feature to adjust Yahoo!'s aspect ratio from the default. Format: An integer value equal to or less than 565.
video_type(string)
The video's MIME-type. Format: A valid MIME-type string. Currently, the only acceptable value is "application/x-shockwave-flash".
title(string)
The video's title. Format: A string of up to 60 characters.
description(string)
A short description of the video. Format: A string of up to 200 characters

Example 2

<head>
    <link rel="image_src" href="http://example.com/thumbnail_preview.jpg" />
    <link rel="video_src" href="http://example.com/video_object.swf"/>
    <meta name="description" content="Cute Overload defines Baroo? as: Dogspeak for 'Whut the...?' 
          Frequently accompanied by the Canine Tilt and/or wrinkled brow for enhanced effect." />
    <meta name="title" content="Baroo? - cute puppies" />
    <meta name="video_height" content="296" />
    <meta name="video_width" content="512" />
    <meta name="video_type" content="application/x-shockwave-flash" />
</head>

This markup not only triggers the Yahoo! Search video player on your page, but provides additional information to help improve the presentation of your result in Yahoo! Search.

Feed

Minimum

Click any item to toggle description on or off

media:thumbnail(gif, jpg, png)
An image that previews the video before the user clicks the "play" button. An image must be paired with a video stream in order for the Yahoo! Search video player to display. Format: A URL to a GIF, PNG, or JPG image. The preview thumbnail must be hosted on the same domain as the video. The image should be 105 x 93 pixels large.
media:video(url)
The video to play when the user clicks the "play" button. A video must be paired with an image in order for the Yahoo! Search video player to display. Format: A URL to a flash video object. The flash video object must be hosted on a domain from the whitelist at the top of this page. By default, the Yahoo! Search video player will scale your flash video to 565 x 461 pixels. You can provide an explicit height and width using media:height and media:width.

Example 1

<y:adjunct xmlns:y="http://search.yahoo.com/datarss/" version="1.0" name="YOURID" >
  <y:item rel="dc:subject" resource="http://example.com/video_object.swf">
      <y:type typeof="media:Video" resource="http://example.com/video_object.swf">
          <y:item rel="media:thumbnail media:image" resource="http://example.com/thumbnail_preview.jpg"/>
          <y:item rel="dc:license" resource="http://example.com/terms_of_service.html" />
          <y:meta property="dc:title media:title">Baroo? - cute puppies</y:meta>
          <y:meta property="dc:description media:description">Cute Overload defines Baroo? as: Dogspeak for 'Whut the...?'
            Frequently accompanied by the Canine Tilt and/or wrinkled brow for enhanced effect.</y:meta>
          <y:meta property="media:height" datatype="xsd:integer">358</y:meta>
          <y:meta property="media:width" datatype="xsd:integer">576</y:meta>
          <y:meta property="media:region">us</y:meta>
          <y:meta property="media:region">uk</y:meta>
      <y:meta property="media:type dc:type">application/x-shockwave-flash</y:meta>
      </y:type>
  </y:item>
</y:adjunct>

This markup would be included in a DataRSS feed. It not only triggers the audio player on your page, but provides additional information to help improve the presentation of your result in Yahoo! Search.

Recommended

Click any item to toggle description on or off

dc:contributor(string)
The full name or username of the person who uploaded the video. Format: A string of up to 60 characters.
dc:creator(string)
The name of the person or organization that created the video. Format: A string of up to 60 characters.
dc:date(date)
A date or timestamp indicating when the video was last uploaded or modified. Format: A date or timestamp, as defined by http://www.w3.org/TR/NOTE-datetime.
dc:description(string)
A short description of the video. Format: A string of up to 200 characters.
dc:identifier(string)
An unambiguous reference to the video, such as the video's unique URL. Format: A string of up to 200 characters.
dc:license(url)
Indicates the license for this content. You may use dc:license or cc:license. If you supply a Creative Commons license URL using cc:license, Yahoo! Search may use this information to help users find content that is in the public domain or under a Creative Commons license. Format: A URL pointing to a human-readable license file.
dc:subject(string)
The video's category or subject. Format: A string of up to 60 characters.
media:duration(integer)
The duration of the video in seconds. Format: An integer.
media:height(integer)
The video's height in pixels, including any "chrome" provided by the third party player. By default, the Yahoo! Search video player scales the object it receives to 565 x 461 pixels. If you provide an explicit height < 461 pixels, Yahoo! Search will confine your video to the specified height. Use this feature to adjust Yahoo!'s aspect ratio from the default. Format: An integer value equal to or less than 461.
media:player(string)
A string identifier for the player used to play the video. Format: A string of up to 60 characters.
media:region(string)
An international region where the video may be played. You may provide multiple media:region fields. Acceptable values include:
ValueRegion
*Play in all regions (default)
nonePlay in no regions
arArgentina - Spanish
auAustralia - English
brBrazil - Portuguese
caCanada - English
clChile - Spanish
coColombia - Spanish
deGermany - German
esSpain - Spanish
frFrance - French
idIndonesia - Bahasa Indonesian
itItalia - Italian
jpJapan - Japanese
mxMexico - Spanish
myMalaysia - English
nzNewZealand - English
pePeru - Spanish
phPhilippines - English
qcQuebec - French
sgSingapore - English
ukUnited Kingdom - English
usUnited States - English
veVenezuela - Spanish
vnVietnam - Vietnamese
Format: A keyword or two-character region code.
  • the keyword "*": play in all regions. If media:region is not present, the value is assumed to be *.
  • the keyword "none": play in no regions. This overrides all other media:regions that might be specified.
  • an intl such as "uk": play in the specified region. This overrides a media:region of *. You may provide multiple media:regions.
media:title(string)
The video's title. Format: A string of up to 60 characters.
media:type(mime-type)
The video's MIME-type. Format: A valid MIME-type string. Currently, the only acceptable value is "application/x-shockwave-flash".
media:views(integer)
The number of times the video has been viewed. Format: An integer.
media:width(integer)
The video's width in pixels, including any "chrome" provided by the third party player. By default, the Yahoo! Search video player scales the object it receives to 565 x 461 pixels. If you provide an explicit width < 565 pixels, Yahoo! Search will confine your video to the specified width. Use this feature to adjust Yahoo!'s aspect ratio from the default. Format: An integer value equal to or less than 565.
review:rating(number)
The numeric rating of the video. Ideally, a number from 0 to 5 corresponding to a star rating. Format: A number.

3. Validate your markup

Test your markup to make sure your enhanced result will appear.

4. Wait until we recrawl your site for your enhanced result to appear on the search results page

This can take up to a few weeks depending on your site.

Copyright © 2009 Yahoo! Inc. All rights reserved. Copyright | Privacy Policy | Terms of Service

Help us continue to improve the Yahoo! Developer Network: Send Your Suggestions