Method: truveo.videos.getVideos - Truveo Video Search XML API

This method can be used to submit a query to the Truveo video search service. This method returns the set of video results that match the submitted query.

Request Parameters

The URL for this method accepts the following parameters:

appid	String value. Required. The Application ID, which is a unique identifier, assigned by Truveo, for your application. To view your current Application ID or request a new one, please consult your My API Account page.
method	String value. Required. The name of the method to invoke. In this case, the value of this argument should be set to 'truveo.videos.getVideos'.
query	String value. Optional. Default value of ' '. The query string that will be submitted to the Truveo video search engine. This string contains your search terms and can also include Boolean operators, modifiers, filters and sorters. For a complete listing of the supported functionality, see the documentation on search query syntax. If no query string or a blank query string is provided, this method will return the top videos ordered by vrank.
results	Integer between 1 and 50. Optional. Default value of 10. The number of results the search engine should attempt to return in response to your request.
start	Integer not less than zero. Optional. Default value of 0. The starting position of the first result, out of the entire set of matching results, that should be returned in response to your request.
showRelatedItems	Integer equal to 0 or 1. Optional. Default value of 0. The flag which indicates if related tags, channels, categories and users should be included in the results returned in response to your request. A value of 1 indicates that these items should be included, and a value of 0 indicates that they should not.
tagResults	Integer between 1 and 50. Optional. Default value of 10. The number of related tags the search engine should attempt to return in response to your request. This parameter is only relevant if 'showRelatedItems' is set to 1.
channelResults	Integer between 1 and 50. Optional. Default value of 10. The number of related channels the search engine should attempt to return in response to your request. This parameter is only relevant if 'showRelatedItems' is set to 1.
categoryResults	Integer between 1 and 50. Optional. Default value of 10. The number of related categories the search engine should attempt to return in response to your request. This parameter is only relevant if 'showRelatedItems' is set to 1.
userResults	Integer between 1 and 50. Optional. Default value of 10. The number of related users the search engine should attempt to return in response to your request. This parameter is only relevant if 'showRelatedItems' is set to 1.
showAdult	Integer equal to 0 or 1. Optional. Default value of 0. The flag which indicates if adult content should be included or excluded in the results returned in response to your request. A value of 1 indicates that adult content should be included, and a value of 0 indicates that adult content should be excluded.
format	String value. xml by default The format in which the response is returned. In this case it is 'json'
callback	String value. The name of the callback javascript function to be invoked in client code for JSONP support. If not specified JSON format is assumed

Response Fields

The JSON response for this method can contain the following fields:

<response>	The top-level object for the JSON response.
<method>	Parent object: <response> An object containing the name of the API method and its authentication level used to retrieve the response.
<data>	Parent object: <response> An object containing all of the actual data in response to the request. Everything other than 'status' and 'method' goes in here
<query>	Parent object: <data> An object containing all of the query related information associated with this response
<queryOriginal>	Parent object: <query> A string containing the original submitted query associated with this response.
<querySuggestion>	Parent object: <query> A string containing a suggested query, if available, for the original submitted query associated with this response.
<queryCategory>	Parent object: <query> A string containing the category, if available, for the original submitted query associated with this response.
<results>	Parent object: <data> An object containing all of the result sets. Eg, videoSet, categorySet, channelSet, showSet, userSet, tagSet.
<videoSet>	Parent object: <results> An object containing all of the video records in the set of returned videos and some information about the set.
<totalResultsAvailable>	Parent object: <videoSet> An integer representing the total number of videos in the entire set of matching videos.
<totalResultsReturned>	Parent object: <videoSet> An integer representing the total number of videos returned in this VideoSet.
<firstResultPosition>	Parent object: <videoSet> An integer representing the position of the first Video in the entire set of matching videos.
<title>	Parent object: <videoSet> A string containing a human-readable title for the set of videos returned in response to the submitted request. For example, this field would return a string such as "Most popular 'madonna' videos in Music on MTV" for the query 'madonna category:Music channel:MTV sort:mostPopular'.
<rssUrl>	Parent object: <videoSet> A string containing the URL which will return an RSS feed for the set of videos returned in response to the submitted query.
<embedTag>	Parent object: <videoSet> A string containing an HTML fragment that can be used to embed the returned video search results into a web page. When this HTML fragment is pasted into an existing webpage, it will automatically display a set of clickable thumbnails for the videos that match the submitted query.
<videos>	Parent object: <videoSet> An array containing all of the video records in the set of returned videos. Each element in the array contains all of the available metadata fields for an individual video record.
<id>	Parent object: <videos> A string which serves as a unique identifier for the video record. Each returned video will always have a valid id value.
<title>	Parent object: <videos> A string containing the title of the video in this result. Each returned video will always contain a title.
<videoUrl>	Parent object: <videos> A string containing the URL which, when be loaded into a browser window, will play the video. Loading this URL into a browser will result in two possible behaviors. For video that plays from an embedded player inside a web page, loading this URL will simply open the web page that contains the embedded video player. For video that plays in a standalone media player, loading this URL will first open the web page which links to the video (also called the 'referrer page') and then open a standalone media player which will play the video. Each returned video will always have a valid videoUrl value.
<channel>	Parent object: <videos> A string containing the name of the channel associated with this video record. For example, this string might contain a value such as 'CNN', 'ESPN', 'MTV', 'YouTube', etc.. Each returned video will always have a valid channel value.
<channelUrl>	Parent object: <videos> A string containing the URL for the channel associated with this video record. For example, this string might contain 'http:\www.cnn.com', 'http:\www.espn.com', etc.. Each returned video will always have a valid channelUrl value.
<dateFound>	Parent object: <videos> A string representation of the date when this video was first indexed by the Truveo video search engine. The format of this date conforms to the RFC 2822 specification. For example, 'Thu, 21 Dec 2000 16:01:07 +0200' is the typical date format. Each returned video will always have a valid dateFound value.
<vRank>	Parent object: <videos> A decimal value between 0 and 1 which represents the rank of this video record in the Truveo video search engine. VRank is an aggregate metric that is continuously calculated and assigned to each video record based on factors such as video popularity, recency, quality, etc.. Unless an alternate sorting operator is applied to the search results, the videos returned in response to a request will be ordered by descending vRank value. Each returned video will always have a valid vRank value.
<textRelevancy>	Parent object: <videos> A decimal value between 0 and 1 indicating how closely the text in the submitted query matches the text in this video record. A higher value indicates that the text in this video record is more closely related to the submitted query.
<description>	Parent object: <videos> A string containing a text description of the video in this result. When provided, this length of this description is typically one to three sentences.
<referrerPageUrl>	Parent object: <videos> A string containing the URL of the web page where a link to the video in this result is located.
<actor>	Parent object: <videos> A string containing the names of one or multiple actors associated with the video in this result. When available, this string is typically a comma-separated list of actor names.
<director>	Parent object: <videos> A string containing the names of one or multiple directors associated with the video in this result. When available, this string is typically a comma-separated list of director names.
<writer>	Parent object: <videos> A string containing the names of one or multiple writers associated with the video in this result. When available, this string is typically a comma-separated list of writer names.
<producer>	Parent object: <videos> A string containing the names of one or multiple producers associated with the video in this result. This field is commonly used for movie trailers and clips. When available, this string is typically a comma-separated list of director names.
<artist>	Parent object: <videos> A string containing the name of the musical artist or group associated with the video in this result. This field is typically used for clips such as music videos.
<album>	Parent object: <videos> A string containing the name of the musical album associated with the video in this result. This field is typically used for clips such as music videos.
<distributor>	Parent object: <videos> A string containing the name of the distribution organization, such as 'Warner Brothers' or 'Sony Pictures', associated with the video in this result.
<author>	Parent object: <videos> A string containing the name of the person or organization responsible for authoring the video associated with this result.
<copyright>	Parent object: <videos> A string containing any applicable copyright message for the video in this result.
<rating>	Parent object: <videos> A string containing the rating for the video in this result. For example, this field may contain a value such as 'G', 'PG-13', 'TV-MA', etc..
<runtime>	Parent object: <videos> An integer which represents the duration of the video clip in seconds.
<category>	Parent object: <videos> A string that contains the category of the video in this result. For example, this field might contain a value such as 'News', 'Sports', 'Movies', etc..
<tags>	Parent object: <videos> A string that contains a comma-delimited list of tags that are used to describe the video in this results. For example, this string might be something like 'funny, jerry seinfeld, TV'.
<showName>	Parent object: <videos> A string that contains the name of the show associated with the video in this result. For example, this field could contain a value such as 'Welcome Back Kotter', 'Star Trek', 'Scrubs', etc.. This field is typically used for television shows and clips.
<showUrl>	Parent object: <videos> A string that contains the URL which will provide additional information about the show identified in the showName field.
<episodeName>	Parent object: <videos> A string that contains the episode name associated with the video in this result. For example, for the television show 'Star Trek', an episode name might be 'The Trouble With Tribbles', 'The Enemy Within', etc.. This field is typically used for television shows and clips.
<episodeNumber>	Parent object: <videos> A string that contains a numerical value representing the episode number associated with the video in this result. This field is typically used for television shows and clips.
<seasonNumber>	Parent object: <videos> A string that contains a numerical value representing the season number associated with the video in this result. This field is typically used for television shows and clips.
<country>	Parent object: <videos> A string that contains the name of the country of origin specified for the video in this result. For example, this field might contain a value such as 'United States', 'France', 'Canada', etc.. Generally, country names will correspond with the ISO 3166-1 specification.
<language>	Parent object: <videos> A string that contains the language associated with the video in this result. For example, this field might contain a value such as 'English', 'French', etc.. Generally, language names will correspond with the ISO 639 specification.
<dateProduced>	Parent object: <videos> A string that describes the date or time period when the video in this result was originally produced.
<registerUrl>	Parent object: <videos> A string containing the URL which provides more information about how to register to access the video in this result. This field is only populated for video that can be viewed for free but requires each user to register with the host site before the video can be viewed.
<subscribeUrl>	Parent object: <videos> A string containing the URL which provides more information about how to subscribe to access the video in this result. This field is only populated for video which requires users to purchase a subscription before the video can be viewed.
<subscribePrice>	Parent object: <videos> A string containing the subscription price, as described by the subscribeUrl. For example, this field could contain the value '$10.99', '€5.99', etc..
<rentUrl>	Parent object: <videos> A string containing the URL which provides more information about how to rent the video in this result. This field is only populated for video that can be rented for a fee.
<rentPrice>	Parent object: <videos> A string containing the rent price, as described by the rentUrl. For example, this field could contain the value '$0.99', '€1.99', etc..
<buyUrl>	Parent object: <videos> A string containing the URL which provides more information about how to buy the video in this result. This field is only populated for video that can be purchased to own.
<buyPrice>	Parent object: <videos> A string containing the purchase price, as described by the buyUrl. For example, this field could contain the value '$14.99', '€10.99', etc..
<live>	Parent object: <videos> An integer indicating if the video in this result is a live stream. If the value of this field is '1', the video is a live stream. Otherwise, the video is not live.
<editorsPick>	Parent object: <videos> An integer indicating if the video in this result has been featured by a human editor. If the value of this field is '1', the video has been promoted in the search results by a human editor.
<viewCount>	Parent object: <videos> An integer representing the number of times the video in this result has been viewed.
<favoriteCount>	Parent object: <videos> An integer representing the number of times the video in this result has been selected as a user favorite.
<userRating>	Parent object: <videos> A decimal value between 0 and 5 representing the average user rating for the video in this result.
<userRatingCount>	Parent object: <videos> An integer representing the number of times this video has been rated.
<thumbnailUrl>	Parent object: <videos> A string containing the URL for the thumbnail image associated with the video in this result. While all thumbnails will not necessarily have a consistent height and width, this thumbnail image will typically have a width of 75 pixels.
<thumbnailUrlLarge>	Parent object: <videos> A string containing the URL for a large-format thumbnail image associated with the video in this result. This thumbnail image will typically have a width of 400 pixels.
<previewVideoUrl>	Parent object: <videos> A string containing the URL that will play a free preview of the video in this record. This field is typically used for premium video, where the video specified by the videoUrl field can only be viewed after a purchase has been made.
<hiDefVideoUrl>	Parent object: <videos> A string containing the URL that will play a high-definition version of the video in this record. For example, for videos that are available in AOL Hi-Q format, this field will provide the URL that, when loaded in a browser, will begin playing a high-definition version of this video.
<videoPlayerEmbedTag>	Parent object: <videos> A string containing the HTML tag which, when embedded in an existing web page, will launch an inline media player to play the video in this result.
<videoResultEmbedTag>	Parent object: <videos> A string containing the HTML tag which, when embedded in an existing web page, will display a thumbnail and related information about the video in this result. When this thumbnail is clicked, it will launch the appropriate media player to play the video.
<quality>	Parent object: <videos> A string that describes the quality of the video in this result. For example, the value of this field could be 'excellent', 'good', 'fair' or 'poor'.
<formats>	Parent object: <videos> A string containing a comma-separated list of the formats supported by the video in this result. For example, for a video that can be played using Windows Media Player, RealPlayer, or QuickTime, the value in this field would be 'win, real, qt'.
<bitrate>	Parent object: <videos> A string such as '300 kbps' that describes the bitrate of the video in this result.
<width>	Parent object: <videos> An integer representing the value in pixels for the width of the video in this result.
<height>	Parent object: <videos> An integer representing the value in pixels for the height of the video in this result.
<fileSize>	Parent object: <videos> A string such as '5204 kb' that specifies the size of the file associated with the video in this result.
<frameRate>	Parent object: <videos> A string such as '24 fps' that specifies the frame rate of this video in this result.
<codec>	Parent object: <videos> A string that identifies the codec used to encode the video in this result.
<sponsored>	Parent object: <videos> An integer representing the type of sponsored result this video is. 0 indicates unsponsored result, 1 indicates contextually relevant sponsored result, and 2 indicates a non-contextual sponsored result. For testing purposes, these queries always return a sponsored result: 'vsl', 'sim:3276274608'.
<canonicalId>	Parent object: <videos> A video record can have multiple unique identifiers. The canonical id is designed to be used for the canonical link element so that one video record only has one identifier for SEO purposes.
<redirectFor>	Parent object: <Video> For certain browsers, a video cannot be displayed in an iframe. This field lists these browsers for the video, if any.
<tagSet>	Parent object: <results> An object containing all of the tags associated with the entire set of matching videos and ome information about the set. The tagSet is returned only if the parameter 'showRelatedItems' is set to 1 or 2.
<totalResultsReturned>	Parent object: <tagSet> An integer representing the total number of tags returned in this tagSet.
<firstResultPosition>	Parent object: <tagSet> An integer representing the position of the first Tag in the set of returned tags.
<tags>	Parent object: <tagSet> An array of objects containing all of the tags. Each element in the array is a tag object that holds the name and count values of a single tag.
<name>	Parent object: <tags> A string containing the name of the tag.
<count>	Parent object: <tags> An integer representing the total number of times this tag has been assigned to any of the videos in the result set.
<channelSet>	Parent object: <results> An object containing all of the channels associated with the entire set of matching videos and some information about the set. The channelSet is returned only if the parameter 'showRelatedItems' is set to 1 or 2.
<totalResultsReturned>	Parent object: <channelSet> An integer representing the total number of channels returned in this channelSet.
<firstResultPosition>	Parent object: <channelSet> An integer representing the position of the first Channel in the set of returned channels.
<channels>	Parent object: <channelSet> An array of objects containing all of channels. Each element in the array is a channel object that hols the name and count values of a single channel.
<name>	Parent object: <channels> A string containing the name of the channel.
<count>	Parent object: <channels> An integer representing the total number of times this channel has been assigned to any of the videos in the result set.
<categorySet>	Parent object: <results> An object containing all of the categories associated with the entire set of matching videos and some information about the set. The categorySet is returned only if the parameter 'showRelatedItems' is set to 1 or.
<totalResultsReturned>	Parent object: <categorySet> An integer representing the total number of categories returned in this categorySet.
<firstResultPosition>	Parent object: <categorySet> An integer representing the position of the first Category in the set of returned categories.
<categories>	Parent object: <categorySet> An array of objects containing all of the categories. Each element in the array is a category object that holds the name and count values of a single category.
<name>	Parent object: <categories> A string containing the name of the category.
<count>	Parent object: <categories> An integer representing the total number of times this category has been assigned to any of the videos in the result set.
<userSet>	Parent object: <results> An object containing all of the users associated with the entire set of matching videosand some information about the set. The userSet is returned only if the parameter 'showRelatedItems' is set to 1 or 2.
<totalResultsReturned>	Parent object: <userSet> An integer representing the total number of users returned in this userSet.
<firstResultPosition>	Parent object: <userSet> An integer representing the position of the first User in the set of returned users.
<users>	Parent object: <userSet> An array of objects containing all of the users. Each element in the array is a user object that holds the name and count values of a single user.
<name>	Parent object: <users> A string containing the name of the user.
<count>	Parent object: <users> An integer representing the total number of times this user has been assigned to any of the videos in the result set.

Example JSON Request URL

A sample REST-style request for this method can be constructed as follows:

http://xml.truveo.com/apiv3
      ?appid=[myAppId]
      &method=truveo.videos.getVideos
      &query=Jennifer+Lopez
      &results=5
      &start=0
      &showRelatedItems=1
      &tagResults=10
      &channelResults=10
      &categoryResults=10
      &userResults=10
      &showAdult=0
      &format=json
      &callback=parseJSON

Example JSON Response

A sample JSON response for this method is listed in the text field below. Click here for a sample JSON reply

HTTP/1.1 200 OK
Date: Sat, 21 Nov 2009 21:42:05 GMT
Server: Apache
X-Powered-By: PHP/5.1.3
Transfer-Encoding: chunked
Content-Type: application/json

parseJSON( {"response":{"status":{"code":200,"text":"OK"},"method":{"service":"api","name":"truveo.videos.getVideos","auth":"none"},"data":{"query":{"queryOriginal":"Jennifer Lopez","deletedWords":"","querySuggestion":"","queryCategory":"default","partialMatch":0},"results":{"videoSet":{"totalResultsAvailable":20961,"totalResultsReturned":5,"firstResultPosition":0,"title":"Jennifer Lopez Videos","rssurl":"http:\/\/xml.truveo.com\/rss?query=Jennifer Lopez&amp;showAdult=0&amp;a=a7c9b8960661eb8a0ded91b23a9ea9b9","embedTag":"<embed src=\"http:\/\/www.truveo.com\/truveo_listWidget.swf?query=Jennifer Lopez&resultsnum=5\" quality=\"high\" wmode=\"transparent\" type=\"application\/x-shockwave-flash\" width=\"600\" height=\"150\"><\/embed>","videos":[{"id":1313288275,"canonicalId":1313288275,"title":"Jennifer Lopez","sponsored":0,"videoUrl":"http:\/\/xml.truveo.com\/rd?i=1310147450&a=a7c9b8960661eb8a0ded91b23a9ea9b9&p=1&h=4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5","channel":"Hulu","channelUrl":"http:\/\/www.hulu.com","dateFound":"Thu, 05 Nov 2009 00:51:49 -0500","textRelevancy":454,"vrank":0.421454,"description":"Is Samia ready to take over the block? The Look-A-Like Style team takes this Mexican-born beauty to the next level as she is made over as Jennifer Lopez.","referrerPageUrl":"http:\/\/www.hulu.com","actor":"","director":"","writer":"","producer":"","artist":"","album":"","distributor":"","author":"","copyright":"2009 - TV Guide","rating":0,"runtime":1685,"category":"TV","tags":"TV, Full Episode, Jennifer Lopez, Look-A-Like, TV Guide, Celebrity, Makeover, Hair, Make-Up, Lookalike, Look A Like","showName":"Look-A-Like","showUrl":"http:\/\/www.hulu.com\/look-a-like","episodeName":"Jennifer Lopez","episodeNumber":"1","seasonNumber":"5","country":"United States","language":"English","dateProduced":"2009-11-04T17:04:09Z","registerUrl":"","subscribeUrl":"","rentUrl":"","buyUrl":"","live":0,"viewCount":84,"favoriteCount":0,"userRating":0,"userRatingCount":0,"thumbnailURL":"http:\/\/thumbnails.truveo.com\/0007\/DF\/4E\/DF4E0A46602508D06FD4E5.jpg","thumbnailURLLarge":"","previewVideoUrl":"","hiDefVideoUrl":"","videoResultEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/1310147450\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/1\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\" width=\" 425\" height=\" 245\"><\/embed>","adultFlag":0,"videoPlayerEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/1310147450\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/1\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\" width=\" 425\" height=\" 245\"><\/embed>","quality":"","formats":"flash","bitrate":0,"width":0,"height":0,"fileSize":0,"frameRate":0,"codec":""},{"id":818159081,"canonicalId":818159081,"title":"Play","sponsored":0,"videoUrl":"http:\/\/xml.truveo.com\/rd?i=819864217&a=a7c9b8960661eb8a0ded91b23a9ea9b9&p=2&h=4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5","channel":"Sony BMG","channelUrl":"http:\/\/www.sonybmg.com\/musicbox\/","dateFound":"Tue, 17 Nov 2009 22:26:49 -0500","textRelevancy":419,"vrank":0.421041,"description":"","referrerPageUrl":"http:\/\/www.sonybmg.com\/musicbox\/","actor":"","director":"","writer":"","producer":"","artist":"Jennifer Lopez","album":"","distributor":"","author":"","copyright":"","rating":0,"runtime":0,"category":"Music","tags":"","showName":"","showUrl":"","episodeName":"","episodeNumber":"","seasonNumber":"","country":"United States","language":"English","dateProduced":"","registerUrl":"","subscribeUrl":"","rentUrl":"","buyUrl":"","live":0,"viewCount":39,"favoriteCount":0,"userRating":0,"userRatingCount":0,"thumbnailURL":"http:\/\/thumbnails.truveo.com\/0008\/4E\/42\/4E42304F513260A8B3C288.jpg","thumbnailURLLarge":"","previewVideoUrl":"","hiDefVideoUrl":"","videoResultEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/819864217\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/2\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" bgcolor=\"#FFFFFF\" flashVars=\"videoId=36142312001&playerID=10172910001&domain=embed&\" base=\"http:\/\/admin.brightcove.com\" name=\"flashObj\" width=\" 425\" height=\" 360\" seamlesstabbing=\"false\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\"swLiveConnect=\"true\" pluginspage=\"http:\/\/www.macromedia.com\/shockwave\/download\/index.cgi?P1_Prod_Version=ShockwaveFlash\"><\/embed>","adultFlag":0,"videoPlayerEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/819864217\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/2\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" bgcolor=\"#FFFFFF\" flashVars=\"videoId=36142312001&playerID=10172910001&domain=embed&\" base=\"http:\/\/admin.brightcove.com\" name=\"flashObj\" width=\" 425\" height=\" 360\" seamlesstabbing=\"false\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\"swLiveConnect=\"true\" pluginspage=\"http:\/\/www.macromedia.com\/shockwave\/download\/index.cgi?P1_Prod_Version=ShockwaveFlash\"><\/embed>","quality":"","formats":"flash","bitrate":0,"width":0,"height":0,"fileSize":0,"frameRate":0,"codec":""},{"id":513636019,"canonicalId":513636019,"title":"Waiting For Tonight","sponsored":0,"videoUrl":"http:\/\/xml.truveo.com\/rd?i=518117585&a=a7c9b8960661eb8a0ded91b23a9ea9b9&p=3&h=4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5","channel":"Sony BMG","channelUrl":"http:\/\/www.sonybmg.com\/musicbox\/","dateFound":"Tue, 17 Nov 2009 22:25:39 -0500","textRelevancy":419,"vrank":0.416289,"description":"","referrerPageUrl":"http:\/\/www.sonybmg.com\/musicbox\/","actor":"","director":"","writer":"","producer":"","artist":"Jennifer Lopez","album":"","distributor":"","author":"","copyright":"","rating":0,"runtime":0,"category":"Music","tags":"","showName":"","showUrl":"","episodeName":"","episodeNumber":"","seasonNumber":"","country":"United States","language":"English","dateProduced":"","registerUrl":"","subscribeUrl":"","rentUrl":"","buyUrl":"","live":0,"viewCount":10,"favoriteCount":0,"userRating":0,"userRatingCount":0,"thumbnailURL":"http:\/\/thumbnails.truveo.com\/0007\/CB\/5C\/CB5CD87B82E3871299BDE7.jpg","thumbnailURLLarge":"","previewVideoUrl":"","hiDefVideoUrl":"","videoResultEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/518117585\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/3\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" bgcolor=\"#FFFFFF\" flashVars=\"videoId=36143227001&playerID=10172910001&domain=embed&\" base=\"http:\/\/admin.brightcove.com\" name=\"flashObj\" width=\" 425\" height=\" 360\" seamlesstabbing=\"false\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\"swLiveConnect=\"true\" pluginspage=\"http:\/\/www.macromedia.com\/shockwave\/download\/index.cgi?P1_Prod_Version=ShockwaveFlash\"><\/embed>","adultFlag":0,"videoPlayerEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/518117585\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/3\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" bgcolor=\"#FFFFFF\" flashVars=\"videoId=36143227001&playerID=10172910001&domain=embed&\" base=\"http:\/\/admin.brightcove.com\" name=\"flashObj\" width=\" 425\" height=\" 360\" seamlesstabbing=\"false\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\"swLiveConnect=\"true\" pluginspage=\"http:\/\/www.macromedia.com\/shockwave\/download\/index.cgi?P1_Prod_Version=ShockwaveFlash\"><\/embed>","quality":"","formats":"flash","bitrate":0,"width":0,"height":0,"fileSize":0,"frameRate":0,"codec":""},{"id":1082580860,"canonicalId":1082580860,"title":"Hold It Don\u2019t Drop It","sponsored":0,"videoUrl":"http:\/\/xml.truveo.com\/rd?i=1088373066&a=a7c9b8960661eb8a0ded91b23a9ea9b9&p=4&h=4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5","channel":"Sony BMG","channelUrl":"http:\/\/www.sonybmg.com\/musicbox\/","dateFound":"Tue, 17 Nov 2009 22:20:03 -0500","textRelevancy":419,"vrank":0.415343,"description":"","referrerPageUrl":"http:\/\/www.sonybmg.com\/musicbox\/","actor":"","director":"","writer":"","producer":"","artist":"Jennifer Lopez","album":"","distributor":"","author":"","copyright":"","rating":0,"runtime":0,"category":"Music","tags":"","showName":"","showUrl":"","episodeName":"","episodeNumber":"","seasonNumber":"","country":"United States","language":"English","dateProduced":"","registerUrl":"","subscribeUrl":"","rentUrl":"","buyUrl":"","live":0,"viewCount":6,"favoriteCount":0,"userRating":0,"userRatingCount":0,"thumbnailURL":"http:\/\/xml.truveo.com\/th\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\/p\/0006\/ED\/90\/ED901ACFA1E92FC51EC7B8.jpg","thumbnailURLLarge":"","previewVideoUrl":"","hiDefVideoUrl":"","videoResultEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/1088373066\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/4\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" bgcolor=\"#FFFFFF\" flashVars=\"videoId=42110119001&playerID=10172910001&domain=embed&\" base=\"http:\/\/admin.brightcove.com\" name=\"flashObj\" width=\" 425\" height=\" 360\" seamlesstabbing=\"false\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\"swLiveConnect=\"true\" pluginspage=\"http:\/\/www.macromedia.com\/shockwave\/download\/index.cgi?P1_Prod_Version=ShockwaveFlash\"><\/embed>","adultFlag":0,"videoPlayerEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/1088373066\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/4\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" bgcolor=\"#FFFFFF\" flashVars=\"videoId=42110119001&playerID=10172910001&domain=embed&\" base=\"http:\/\/admin.brightcove.com\" name=\"flashObj\" width=\" 425\" height=\" 360\" seamlesstabbing=\"false\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\"swLiveConnect=\"true\" pluginspage=\"http:\/\/www.macromedia.com\/shockwave\/download\/index.cgi?P1_Prod_Version=ShockwaveFlash\"><\/embed>","quality":"","formats":"flash","bitrate":0,"width":0,"height":0,"fileSize":0,"frameRate":0,"codec":""},{"id":1771775862,"canonicalId":1771775862,"title":"Baby I Love U!","sponsored":0,"videoUrl":"http:\/\/xml.truveo.com\/rd?i=1765082095&a=a7c9b8960661eb8a0ded91b23a9ea9b9&p=5&h=4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5","channel":"Sony BMG","channelUrl":"http:\/\/www.sonybmg.com\/musicbox\/","dateFound":"Tue, 17 Nov 2009 22:19:50 -0500","textRelevancy":419,"vrank":0.414966,"description":"","referrerPageUrl":"http:\/\/www.sonybmg.com\/musicbox\/","actor":"","director":"","writer":"","producer":"","artist":"Jennifer Lopez","album":"","distributor":"","author":"","copyright":"","rating":0,"runtime":0,"category":"Music","tags":"","showName":"","showUrl":"","episodeName":"","episodeNumber":"","seasonNumber":"","country":"United States","language":"English","dateProduced":"","registerUrl":"","subscribeUrl":"","rentUrl":"","buyUrl":"","live":0,"viewCount":6,"favoriteCount":0,"userRating":0,"userRatingCount":0,"thumbnailURL":"http:\/\/thumbnails.truveo.com\/0008\/EB\/05\/EB056F9F4D82B2B13BC23C.jpg","thumbnailURLLarge":"","previewVideoUrl":"","hiDefVideoUrl":"","videoResultEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/1765082095\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/5\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" bgcolor=\"#FFFFFF\" flashVars=\"videoId=1463294091&playerID=10172910001&domain=embed&\" base=\"http:\/\/admin.brightcove.com\" name=\"flashObj\" width=\" 425\" height=\" 360\" seamlesstabbing=\"false\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\"swLiveConnect=\"true\" pluginspage=\"http:\/\/www.macromedia.com\/shockwave\/download\/index.cgi?P1_Prod_Version=ShockwaveFlash\"><\/embed>","adultFlag":0,"videoPlayerEmbedTag":"<embed src=\"http:\/\/xml.truveo.com\/eb\/i\/1765082095\/a\/a7c9b8960661eb8a0ded91b23a9ea9b9\/p\/5\/h\/4b085ead3bf8904:cb1098bc4ed568507f08b6301c4f64a5\" bgcolor=\"#FFFFFF\" flashVars=\"videoId=1463294091&playerID=10172910001&domain=embed&\" base=\"http:\/\/admin.brightcove.com\" name=\"flashObj\" width=\" 425\" height=\" 360\" seamlesstabbing=\"false\" type=\"application\/x-shockwave-flash\" allowFullScreen=\"true\"swLiveConnect=\"true\" pluginspage=\"http:\/\/www.macromedia.com\/shockwave\/download\/index.cgi?P1_Prod_Version=ShockwaveFlash\"><\/embed>","quality":"","formats":"flash","bitrate":0,"width":0,"height":0,"fileSize":0,"frameRate":0,"codec":""}]},"tagSet":{"totalResultsReturned":10,"firstResultPosition":0,"tags":[{"name":"Lopez","count":"154"},{"name":"Jennifer","count":"154"},{"name":"Jennifer Lopez","count":"93"},{"name":"Pop","count":"85"},{"name":"J.Lo","count":"39"},{"name":"Music Video","count":"32"},{"name":"Epic","count":"23"},{"name":"louboutins","count":"22"},{"name":"Music","count":"22"},{"name":"Out","count":"21"}]},"categorySet":{"totalResultsReturned":10,"firstResultPosition":0,"categories":[{"name":"TV","count":21},{"name":"Music","count":8118},{"name":"Entertainment","count":7184},{"name":"Movies","count":430},{"name":"News","count":513},{"name":"Lifestyles","count":108},{"name":"Sports","count":130},{"name":"Comedy","count":595},{"name":"Technology","count":12},{"name":"Government","count":37}]},"channelSet":{"totalResultsReturned":10,"firstResultPosition":0,"channels":[{"name":"Hulu","count":14},{"name":"Sony BMG","count":29},{"name":"MTVM","count":63},{"name":"CelebTV","count":9},{"name":"MusicPlayOn","count":44},{"name":"music.com","count":18},{"name":"Access Hollywood","count":25},{"name":"TV Guide","count":160},{"name":"moviefone","count":25},{"name":"MSNBC","count":13}]},"userSet":{"totalResultsReturned":0,"firstResultPosition":0},"showSet":[]}}}} );

Errors

If execution of this method is not successful, the following error codes can be returned:

1	Invalid request: 'appid' An application ID was not submitted with the request.
2	Invalid request: 'method' A method was not submitted with the request.
5	Invalid request: 'query' The query parameter was not submitted with the request.
3	Invalid request: 'start' The start parameter must be a non-negative integer.
4	Invalid request: 'results' The results parameter must be an integer between 1 and 50.
7	Invalid request: 'showAdult' The showAdult parameter must be 0 or 1.
21	Invalid request: 'showRelatedItems' The showRelatedItems parameter must be 0 or 1.
8	Invalid request: 'tagresults' The tagresults parameter must be an integer between 1 and 50.
9	Invalid request: 'channelresults' The channelresults parameter must be an integer between 1 and 50.
10	Invalid request: 'categoryresults' The categoryresults parameter must be an integer between 1 and 50.
11	Invalid request: 'userresults' The userresults parameter must be an integer between 1 and 50.
12	Service Unavailable Truveo Video Search API service unavailable.
13	Method not found. The method you submitted with the request was not valid.
14	Access Denied: invalid appid. The application ID submitted with the request is invalid.
15	Access Denied: appid over limit. The application ID submitted with the request is over the daily request limit.

You are not logged in. Log In
	Developer Center