Video Search Method

Returns a list of videos for a specific search term.

Method Path

http://api.mtvnservices.com/1/video/search/[parameters]

Method Parameters

Parameter Description Required
term Specify the search query with the term parameter. The MTVN Content API will search for the term or terms within all available video metadata. You must URL-escape all spaces, punctuation and quotes. The search term "buddy holly" would look like this %22buddy+holly%22 . Yes

Atom Request Example

http://api.mtvnservices.com/1/video/search/?term=shins&start-index=1&max-results=1

Atom Return Example

<?xml version="1.0" encoding="iso-8859-1"?>
<feed xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://www.w3.org/2005/Atom">
<id>http://api.mtvnservices.com/1/video/search/</id>
<updated>2008-11-06T14:09:18.303-05:00</updated>
<title>MTVN Content API video search for "shins"</title>
<link rel="self" type="application/atom+xml" href="http://api.mtvnservices.com/1/video/search/?term=shins&amp;start-index=1&amp;max-results=1"/>
<link rel="next" type="application/atom+xml" href="http://api.mtvnservices.com/1/video/search/?term=shins&amp;start-index=2&amp;max-results=1"/>
<opensearch:totalResults>11</opensearch:totalResults>
<opensearch:startIndex>1</opensearch:startIndex>
<opensearch:itemsPerPage>1</opensearch:itemsPerPage>

<entry>
<id>http://api.mtvnservices.com/1/video/hznHivqrbHHDSNZGA/</id>
<published>2007-01-23T00:00:00Z</published>
<updated>2008-11-06T14:09:18.303-05:00</updated>
<title>Sleeping Lessons</title>
<content>The Shins | Sleeping Lessons | Sub Pop Records</content>
<link rel="self" type="application/atom+xml" href="http://api.mtvnservices.com/1/video/hznHivqrbHHDSNZGA/"/>
<link rel="http://api.mtvnservices.com/1/schemas/artist" type="application/atom+xml" href="http://api.mtvnservices.com/1/artist/shins_the/"/>
<link rel="http://api.mtvnservices.com/1/schemas/genre" type="application/atom+xml" title="Alternative" href="http://api.mtvnservices.com/1/genre/alternative/"/>
<author>
<name>The Shins</name>
<uri>http://api.mtvnservices.com/1/artist/shins_the/</uri>
</author>
<media:content url="http://media.mtvnservices.com/mgid:uma:video:api.mtvnservices.com:169284"
duration="239"
type="application/x-shockwave-flash"
medium="video"
isDefault="true"
expression="full"/>
<media:player url="http://www.mtv.com/overdrive/?vid=169284"/>
<media:title>Sleeping Lessons</media:title>
<media:description>The Shins | Sleeping Lessons | Sub Pop Records</media:description>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/70x53.jpg" height="53" width="70"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/84x77.jpg" height="77" width="84"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/140x105.jpg" height="105" width="140"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/281x211.jpg" height="211" width="281"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/320x240.jpg" height="240" width="320"/>
<media:restriction type="country" relationship="allow">all </media:restriction>
<media:keywords><![CDATA[The Shins, Sleeping Lessons, Antonio Campos,]]></media:keywords>
<media:credit role="director" scheme="urn:ebu">Antonio Campos</media:credit>
<media:credit role="artist/performer" scheme="urn:ebu">The Shins</media:credit>
<media:category scheme="urn:mtvn:governing_agreement" label="Governing Agreement">6</media:category>
</entry>
</feed>

MRSS Request Example

http://api.mtvnservices.com/1/video/search/?term=shins&start-index=1&max-results=1&feed-format=mrss

MRSS Return Example

<?xml version="1.0" encoding="iso-8859-1"?>
<rss xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
<channel>
<title>MTVN Content API video search for "shins"</title>
<link>http://api.mtvnservices.com/1/video/search/</link>
<description/>
<atom:link rel="self" type="application/atom+xml" href="http://api.mtvnservices.com/1/video/search/?term=shins&amp;start-index=1&amp;max-results=1"/>
<atom:link rel="next" type="application/atom+xml" href="http://api.mtvnservices.com/1/video/search/?term=shins&amp;start-index=2&amp;max-results=1"/>
<opensearch:totalResults>11</opensearch:totalResults>
<opensearch:startIndex>1</opensearch:startIndex>
<opensearch:itemsPerPage>1</opensearch:itemsPerPage>

<item>
<title>Sleeping Lessons</title>
<guid>http://api.mtvnservices.com/1/video/hznHivqrbHHDSNZGA/</guid>
<pubDate>Tue, 23 Jan 2007 00:00:00 GMT</pubDate>
<description>The Shins | Sleeping Lessons | Sub Pop Records</description>
<atom:link rel="self" type="application/atom+xml" href="http://api.mtvnservices.com/1/video/hznHivqrbHHDSNZGA/"/>
<atom:link rel="http://api.mtvnservices.com/1/schemas/artist" type="application/atom+xml" href="http://api.mtvnservices.com/1/artist/shins_the/"/>
<atom:link rel="http://api.mtvnservices.com/1/schemas/genre" type="application/atom+xml" title="Alternative" href="http://api.mtvnservices.com/1/genre/alternative/"/>
<media:content url="http://media.mtvnservices.com/mgid:uma:video:api.mtvnservices.com:169284"
duration="239"
type="application/x-shockwave-flash"
medium="video"
isDefault="true"
expression="full"/>
<media:player url="http://www.mtv.com/overdrive/?vid=169284"/>
<media:title>Sleeping Lessons</media:title>
<media:description>The Shins | Sleeping Lessons | Sub Pop Records</media:description>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/70x53.jpg" height="53" width="70"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/84x77.jpg" height="77" width="84"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/140x105.jpg" height="105" width="140"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/281x211.jpg" height="211" width="281"/>
<media:thumbnail url="http://www.mtv.com/shared/promoimages/bands/s/shins_the/sleeping_lessons/320x240.jpg" height="240" width="320"/>
<media:restriction type="country" relationship="allow">all </media:restriction>
<media:keywords><![CDATA[The Shins, Sleeping Lessons, Antonio Campos,]]></media:keywords>
<media:credit role="director" scheme="urn:ebu">Antonio Campos</media:credit>
<media:credit role="artist/performer" scheme="urn:ebu">The Shins</media:credit>
<media:category scheme="urn:mtvn:governing_agreement" label="Governing Agreement">6</media:category>
</item>
</channel>
</rss>

version 8 as of 2 months ago by ajay

Comments

New comments are not being accepted at this time.