- Previous: Documentation Home
- Up: Documentation Home
- Next: Generic Feed Parameters
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>
- Previous: Documentation Home
- Up: Documentation Home
- Next: Generic Feed Parameters
Docs Navigation
- Documentation Home
- Video Feeds & Entries
- Generic Feed Parameters
- Powered By MTV Badges
- Video Search Method
- Video Method
- Artist Alias Method
- Artist Videos Method
- Artist Search Method
- Artist Browse Method
- Related Artist Method
- Genre Alias Method
- Genre Artists Method
- Genre Videos Method
- Invalid Artist Alias
- Invalid Method
- Invalid Video ID

Comments
New comments are not being accepted at this time.