Lists all videos that were uploaded by the specified user.

Note: ALL arguments are required.

Authenication

Authentication is optional. After authenticating and using sessionid parameter, you may ask about your private data using this method. Asking about private data without authentication will result with returning empty data set or an error.

For hidden accounts: All hidden accounts must authenticate in order to see their videos.

Arguments

method
Should be set to “Viddler.videos.getByUser”
api_key
Assigned Viddler API Key
sessionid (optional)
Current session in generated by calling viddler.users.auth method
user
The chosen Viddler user name. You can provide multiple coma separated viddler usernames
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.
tags (optional)
The tags you would like to filter your query by.
sort (optional)
How you would like to sort your query (views-asc,views-desc,uploaded-asc,uploaded-desc)
visibility (optional)
Sort by public, shared, private. Requires: SessionID Limit: Can not filter by tags and visibility at the same time.

Example Call

http://www.viddler.com/rest/v1/?method=viddler.videos.getByUser&api_key=key&user=user&page=1&per_page=10

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 total="25">
  <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>

Error Codes

Standard error codes plus:

Error # Description
101 Username not found.

Changelog

  • Version 1.1.0
    • User parameter now accepts multiple coma separated usernames