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: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 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: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>
<media:category scheme="urn:mtvn:mgid" label="mgid">mgid:uma:video:api.mtvnservices.com:170350</media:category>
</entry>

...

</feed>

version 14 as of 9 months ago by justintormey

Comments

New comments are not being accepted at this time.