method-videos-getByUser
Last edited: April 7th, 2009 by Colin DevroeLists 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)
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