Video Search Method
- Previous: Powered By MTV Badges
- Up: Documentation Home
- Next: Video 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&start-index=1&max-results=1"/>
<link rel="next" type="application/atom+xml" href="http://api.mtvnservices.com/1/video/search/?term=shins&start-index=2&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&start-index=1&max-results=1"/>
<atom:link rel="next" type="application/atom+xml" href="http://api.mtvnservices.com/1/video/search/?term=shins&start-index=2&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>
- Previous: Powered By MTV Badges
- Up: Documentation Home
- Next: Video Method
Docs Navigation
- Documentation Home
- Video Feeds & Entries
- Video Player Embed Code
- Video Player API
- 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.