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: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>
<media:category scheme="urn:mtvn:mgid" label="mgid">mgid:uma:video:mtvmusic.com:169284</media:category>

</entry>
</feed>

version 9 as of 9 months ago by justintormey

Comments

New comments are not being accepted at this time.