|
totalResultsAvailable
|
An integer representing the total number of videos in the entire set of matching videos.
Usage syntax:
myVar = TVS.VideoSet.totalResultsAvailable;
|
|
totalResultsReturned
|
An integer representing the total number of videos returned in this VideoSet.
Usage syntax:
myVar = TVS.VideoSet.totalResultsReturned;
|
|
firstResultPosition
|
An integer representing the position of the first Video in the entire set of matching videos.
Usage syntax:
myVar = TVS.VideoSet.firstResultPosition;
|
|
title
|
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'.
Usage syntax:
myVar = TVS.VideoSet.title;
|
|
rssUrl
|
A string containing the URL which will return an RSS feed for the set of videos returned in response to the submitted query.
Usage syntax:
myVar = TVS.VideoSet.rssUrl;
|
|
embedTag
|
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.
Usage syntax:
myVar = TVS.VideoSet.embedTag;
|
|
Video
|
The container for all of the available metadata fields for an individual video record.
Usage syntax:
myVar = TVS.VideoSet.Video[index];
|
|
id
|
A string which serves as a unique identifier for the video record. Each returned video will always have a valid id value.
Usage syntax:
myVar = TVS.VideoSet.Video[index].id;
|
|
title
|
A string containing the title of the video in this result. Each returned video will always contain a title.
Usage syntax:
myVar = TVS.VideoSet.Video[index].title;
|
|
videoUrl
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].videoUrl;
|
|
channel
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].channel;
|
|
channelUrl
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].channelUrl;
|
|
dateFound
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].dateFound;
|
|
vRank
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].vRank;
|
|
textRelevancy
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].textRelevancy;
|
|
description
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].description;
|
|
referrerPageUrl
|
A string containing the URL of the web page where a link to the video in this result is located.
Usage syntax:
myVar = TVS.VideoSet.Video[index].referrerPageUrl;
|
|
actor
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].actor;
|
|
director
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].director;
|
|
writer
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].writer;
|
|
producer
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].producer;
|
|
artist
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].artist;
|
|
album
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].album;
|
|
distributor
|
A string containing the name of the distribution organization, such as 'Warner Brothers' or 'Sony Pictures', associated with the video in this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].distributor;
|
|
author
|
A string containing the name of the person or organization responsible for authoring the video associated with this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].author;
|
|
copyright
|
A string containing any applicable copyright message for the video in this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].copyright;
|
|
rating
|
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..
Usage syntax:
myVar = TVS.VideoSet.Video[index].rating;
|
|
runtime
|
An integer which represents the duration of the video clip in seconds.
Usage syntax:
myVar = TVS.VideoSet.Video[index].runtime;
|
|
category
|
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..
Usage syntax:
myVar = TVS.VideoSet.Video[index].category;
|
|
tags
|
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'.
Usage syntax:
myVar = TVS.VideoSet.Video[index].tags;
|
|
showName
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].showName;
|
|
showUrl
|
A string that contains the URL which will provide additional information about the show identified in the showName field.
Usage syntax:
myVar = TVS.VideoSet.Video[index].showUrl;
|
|
episodeName
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].episodeName;
|
|
episodeNumber
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].episodeNumber;
|
|
seasonNumber
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].seasonNumber;
|
|
country
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].country;
|
|
language
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].language;
|
|
dateProduced
|
A string that describes the date or time period when the video in this result was originally produced.
Usage syntax:
myVar = TVS.VideoSet.Video[index].dateProduced;
|
|
registerUrl
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].registerUrl;
|
|
subscribeUrl
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].subscribeUrl;
|
|
subscribePrice
|
A string containing the subscription price, as described by the subscribeUrl. For example, this field could contain the value '$10.99', '€5.99', etc..
Usage syntax:
myVar = TVS.VideoSet.Video[index].subscribePrice;
|
|
rentUrl
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].rentUrl;
|
|
rentPrice
|
A string containing the rent price, as described by the rentUrl. For example, this field could contain the value '$0.99', '€1.99', etc..
Usage syntax:
myVar = TVS.VideoSet.Video[index].rentPrice;
|
|
buyUrl
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].buyUrl;
|
|
buyPrice
|
A string containing the purchase price, as described by the buyUrl. For example, this field could contain the value '$14.99', '€10.99', etc..
Usage syntax:
myVar = TVS.VideoSet.Video[index].buyPrice;
|
|
live
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].live;
|
|
editorsPick
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].editorsPick;
|
|
viewCount
|
An integer representing the number of times the video in this result has been viewed.
Usage syntax:
myVar = TVS.VideoSet.Video[index].viewCount;
|
|
favoriteCount
|
An integer representing the number of times the video in this result has been selected as a user favorite.
Usage syntax:
myVar = TVS.VideoSet.Video[index].favoriteCount;
|
|
userRating
|
A decimal value between 0 and 5 representing the average user rating for the video in this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].userRating;
|
|
userRatingCount
|
An integer representing the number of times this video has been rated.
Usage syntax:
myVar = TVS.VideoSet.Video[index].userRatingCount;
|
|
thumbnailUrl
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].thumbnailUrl;
|
|
thumbnailUrlLarge
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].thumbnailUrlLarge;
|
|
previewVideoUrl
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].previewVideoUrl;
|
|
hiDefVideoUrl
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].hiDefVideoUrl;
|
|
videoPlayerEmbedTag
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].videoPlayerEmbedTag;
|
|
videoResultEmbedTag
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].videoResultEmbedTag;
|
|
quality
|
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'.
Usage syntax:
myVar = TVS.VideoSet.Video[index].quality;
|
|
formats
|
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'.
Usage syntax:
myVar = TVS.VideoSet.Video[index].formats;
|
|
bitrate
|
A string such as '300 kbps' that describes the bitrate of the video in this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].bitrate;
|
|
width
|
An integer representing the value in pixels for the width of the video in this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].width;
|
|
height
|
An integer representing the value in pixels for the height of the video in this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].height;
|
|
fileSize
|
A string such as '5204 kb' that specifies the size of the file associated with the video in this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].fileSize;
|
|
frameRate
|
A string such as '24 fps' that specifies the frame rate of this video in this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].frameRate;
|
|
codec
|
A string that identifies the codec used to encode the video in this result.
Usage syntax:
myVar = TVS.VideoSet.Video[index].codec;
|
|
sponsored
|
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'.
Usage syntax:
myVar = TVS.VideoSet.Video[index].sponsored;
|
|
canonicalId
|
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.
Usage syntax:
myVar = TVS.VideoSet.Video[index].canonicalId;
|
|
redirectFor
|
For certain browsers, a video cannot be displayed in an iframe. This field lists these browsers for the video, if any.
Usage syntax:
myVar = TVS.VideoSet.Video[index].redirectFor;
|