Uploads a video to a user’s account on Viddler site. To send a file to Viddler’s servers use POST method with Content-Type: multipart/form-data (RFC1867).

Make sure “file” part is sent as the last part of a request. Your upload request will be validated before actual file will be read.

For better videos uploads performance consider using viddler.videos.prepareUpload method which will assign new, one time use API endpoint for video upload call.

Note: ALL arguments are required.

Authenication

This method requires authentication with viddler.users.auth API method.

Arguments

method
Should be set to “Viddler.videos.upload”
api_key
Assigned Viddler API Key
sessionid
The session ID assigned during user authentication.
title
The video title.
tags
The video tags.
description
The video description.
make_public
Use “1″ for true and “0″ for false to choose whether or not the video goes public when uploaded.
file
The video file.
bitrate
(in kilobits per second) The bitrate to encode the current video at, rather than the account default. E.g. 400, 700, or 1500. Note: This method is not available for all accounts. Please inquire.

Example Call

http://api.viddler.com/rest/v1/?method=viddler.videos.upload&api_key=12345&sessionid=9e107d9d372bb6826bd81d3542a419d6&title=My%20Video &tags=travel%20spain&description=Video%20from%20my%20trip%20to%20Spain&file=@video.avi

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<video>
  <id>49e63783</id>
  <title>Test upload</title>
  <description>test upload description</description>
  <url>http://www.viddler.com/explore/username/videos/118/</url>
  <thumbnail_url>http://cdn-ll-83.viddler.com/e2/thumbnail_2_49e63783.jpg</thumbnail_url>
</video>