Please note, that this document is currently being edited. If some things seem out of whack, it is because we’re updating the API.

Adds a text comment to a video

Note: ALL arguments are required.

Authenication

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

Arguments

method
Should be set to “Viddler.videos.comments.add”
api_key
Assigned Viddler API Key
sessionid
Current session in generated by calling viddler.users.auth method
video_id
The ID of the video to get information for. This is the ID that’s returned by upload.video.
text
Body of comment to add
timepoint (optional)
The time the comment should appear on the timeline. Comment will be added as a “global comment” if not provided. (Floating point value e.g. “10.22″)

Example Call

http://api.viddler.com/rest/v1/?method=viddler.videos.comments.add&api_key=KEY&video_id=43253433&text=This%20is%20a%20comment

Example Response

<comment>
  <id>1231233</id>
  <type>text</type>
  <author>steve</author>
  <rating>0</rating>
  <text>comment body</text>
  <add_time>1129773022</add_time>
</comment>