Video Feeds & Entries

The MTVN Content API returns video feeds and entries in Atom or RSS format. Each <entry> corresponds to a single video.

Feed Tag Details

Tag Description
<id> Identifies the return URL.
<updated> Indicates when this feed or return was last updated. The MTVN Content API will cache certain returns to increase performance.
<title> Indicates the feed or return title.
<author><name> Artist specific methods will show the primary artist's name.
<author><uri> Artist specific methods will show the Artist Method URL for the primary artist.
<generator> Indicates which version of the MTVN Content API created the feed or result.
<link rel="self"> Link to current feed or return.

Entry Tag Details

Tag Description
<id> Link to Video Method for the specific video entry.
<published> Indicates either when the video was first released or when it was first published online. If no publish date is available, this tag will default to the current time.
<updated> Indicates when the entry was last updated in the MTVN Content API.
<title> Video title.
<content> Displays the Artist Name, Video Title, and Record Label for the specific video entry.
<link rel="self"> Link to Video Method for the specific video entry.
<author><name> Artist specific methods will show the primary artist's name.
<author><uri> Artist specific methods will show the Artist Method URL for the primary artist.
<media:content> Provides a direct URL to the MTVN Content API flash video player, if video embedding is allowed for that piece of content. Also indicates the duration (if available), media type and medium. If no duration is available, the duration will be listed as "0".
<media:player> Provides a link to the content on MTV.com.
<media:title> Video title.
<media:description> Displays the Artist Name, Video Title, and Record Label for the specific video entry.
<media:thumbnail> If thumbnails are available, each will be listed in order from largest to smallest. Height and width are also listed if available.
<media:restriction> Indicates if a specific video, contained in the <media:content> tag, is available ONLY in certain geographic regions. If no <media:restriction> tag is found, the video is available for ALL geographic regions.
<media:keywords> Displays a coma separated list of keywords for the specific video entry. May be contained within a CDATA section.
<media:credit> Most entries will contain <media:credit> tags for director and artist/performer.

Atom Return Example

<?xml version="1.0" encoding="iso-8859-1"?>
<feed xmlns:media="http://search.yahoo.com/mrss/"
xmlns:atom="http://www.w3.org/2005/Atom"
xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
xmlns="http://www.w3.org/2005/Atom">
<id>http://api.mtvnservices.com/1/artist/shop_boyz/videos/</id>
<updated>2008-08-06T09:05:52.379-04:00</updated>
<title>Shop Boyz Videos</title>
<link rel="self" type="application/atom+xml"
href="http://api.mtvnservices.com/1/artist/shop_boyz/videos/"/>

<link rel="http://api.mtvnservices.com/1/schemas/artist" type="application/atom+xml"
href="http://api.mtvnservices.com/1/artist/shop_boyz/"/>
<entry>
<id>http://api.mtvnservices.com/1/video/hznHivqrbHHDPBXWB/</id>
<published>2007-23-08T00:00:00.000-04:00</published>
<updated>2008-08-06T09:05:52.379-04:00</updated>

<title>They Like Me</title>
<content>Shop Boyz | They Like Me | Ondeck/Universal Republic</content>
<link rel="self" type="application/atom+xml"
href="http://api.mtvnservices.com/1/video/hznHivqrbHHDPBXWB/"/>
<link rel="http://api.mtvnservices.com/1/schemas/artist" type="application/atom+xml"
href="http://api.mtvnservices.com/1/artist/shop_boyz/"/>
<author>
<name>Shop Boyz</name>

<uri>http://api.mtvnservices.com/1/artist/shop_boyz/</uri>
</author>
<media:content url="http://media.mtvnservices.com/mgid:uma:video:api.mtvnservices.com:170350"
duration="210"
type="application/x-shockwave-flash"
medium="video"
isDefault="true"
expression="full"/>
<media:player url="http://www.mtv.com/overdrive/?vid=170350"/>
<media:title>They Like Me</media:title>
<media:description>Shop Boyz | They Like Me | Ondeck/Universal Republic</media:description>

<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/they_like_me/70x53.jpg"
height="53"
width="70"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/they_like_me/84x77.jpg"
height="77"
width="84"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/they_like_me/140x105.jpg"
height="105"
width="140"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/they_like_me/281x105.jpg"
height="105"
width="281"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/they_like_me/281x211.jpg"
height="211"
width="281"/>
<media:thumbnail url="http://www.mtv.com//shared/promoimages/bands/s/shop_boyz/they_like_me/320x240.jpg"
height="240"
width="320"/>
<media:restriction type="country" relationship="allow">CA US </media:restriction>
<media:keywords><![CDATA[Shop Boyz, They Like Me, ghettonerd, Ondeck/Universal Republic]]></media:keywords>

<media:credit role="director" scheme="urn:ebu">ghettonerd</media:credit>
<media:credit role="artist/performer" scheme="urn:ebu">Shop Boyz</media:credit>
<media:category scheme="urn:mtvn:governing_agreement" label="Governing Agreement">3</media:category>
</entry>
<entry>

<id>http://api.mtvnservices.com/1/video/hznHivqrbHHDAGSSZ/</id>
<published>2007-18-05T00:00:00.000-04:00</published>
<updated>2008-08-06T09:05:52.379-04:00</updated>
<title>Party Like A Rock Star</title>
<content>Shop Boyz | Party Like A Rock Star | Ondeck/Universal Republic</content>

<link rel="self" type="application/atom+xml"
href="http://api.mtvnservices.com/1/video/hznHivqrbHHDAGSSZ/"/>
<link rel="http://api.mtvnservices.com/1/schemas/artist" type="application/atom+xml"
href="http://api.mtvnservices.com/1/artist/shop_boyz/"/>
<author>
<name>Shop Boyz</name>
<uri>http://api.mtvnservices.com/1/artist/shop_boyz/</uri>

</author>

<media:content url="http://media.mtvnservices.com/mgid:uma:video:api.mtvnservices.com:148662"
duration="210"
type="application/x-shockwave-flash"
medium="video"
isDefault="true"
expression="full"/>
<media:player url="http://www.mtv.com/overdrive/?vid=148662"/>
<media:title>Party Like A Rock Star</media:title>
<media:description>Shop Boyz | Party Like A Rock Star | Ondeck/Universal Republic</media:description>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/party_like_a_rock_star/70x53.jpg"
height="53"
width="70"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/party_like_a_rock_star/84x77.jpg"
height="77"
width="84"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/party_like_a_rock_star/140x105.jpg"
height="105"
width="140"/>

<media:thumbnail url="http://www.mtv.com/content/ontv/vma/2007/photo/nominees/monster-single/party_like_a_rock_star240x1.jpg"
height="180"
width="240"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/party_like_a_rock_star/281x211.jpg"
height="211"
width="281"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shop_boyz/party_like_a_rock_star/320x240.jpg"
height="240"
width="320"/>
<media:restriction type="country" relationship="allow">AT AU BE CA CH DK FR GB IE MU NG NL NZ US </media:restriction>
<media:keywords><![CDATA[Shop Boyz, Party Like A Rock Star, Marc Klasfeld]]></media:keywords>
<media:credit role="director" scheme="urn:ebu">Marc Klasfeld</media:credit>

<media:credit role="artist/performer" scheme="urn:ebu">Shop Boyz</media:credit>
<media:category scheme="urn:mtvn:governing_agreement" label="Governing Agreement">3</media:category>
</entry>
</feed>

version 12 as of 2 months ago by ajay

Comments

New comments are not being accepted at this time.