Lists all videos that have the specified tag.

Note: ALL arguments are required.

Authenication

This method does not require user authentication.

Arguments

method
Should be set to “Viddler.videos.getByTag”
api_key
Assigned Viddler API Key
tag
The tag to search for
page (optional)
The “page number” of results to retrieve (e.g. 1, 2, 3).
per_page (optional)
The number of results to retrieve per page (maximum 100). If not specified, the default value equals 20.
sort (optional)
How you would like to sort your query (views-asc,views-desc,uploaded-asc,uploaded-desc)

Example Call

http://www.viddler.com/rest/v1/?method=viddler.videos.getByTag&api_key=key&tag=funny

Example Response

This method returns set of video tag elements. Each tag element has the same structure asviddler.videos.getDetails response.

<?xml version="1.0" encoding="UTF-8"?>
<video_list>
  <video>
    <author>username</author>
    <id>32104119</id>
    <title>My video</title>
    <length_seconds>188</length_seconds>
    <description></description>
    <view_count>121</view_count>
    <upload_time>1195445607000</upload_time>
    <comment_count>0</comment_count>
    <url>http://www.viddler.com/explore/username/videos/111/</url>
    <thumbnail_url>http://cdn-ll-79.viddler.com/e2/thumbnail_2_25304271.jpg</thumbnail_url>
  </video>
  <video>
    ...
  </video>
 
  ...
 
</video_list>