API Documentation

posts/vote

Register a vote on a post.

URL

https://disqus.com/api/3.0/posts/vote.json

Accessibility

public key, secret key

Supported request methods

POST

Supported formats

json, jsonp

Requires authentication

no

Rate limited

inherits global rate limit

Arguments

Required

  • vote

    Choices: -1, 0, 1

  • post

    Looks up a post by ID

Example Responses

Expandjson

POST vote=1&post=1

{"code":0,"response":{"vote":0,"likesDelta":0,"post":{"isJuliaFlagged":true,"isFlagged":false,"forum":"bobross","parent":null,"author":{"username":"disqus_api","about":"","name":"disqus_api","url":"","isFollowing":false,"isFollowedBy":false,"profileUrl":"http://disqus.com/disqus_api/","avatar":{"permalink":"http://disqus.com/api/users/avatars/disqus_api.jpg","cache":"http://mediacdn.disqus.com/1091/images/noavatar92.png"},"id":"1","isAnonymous":false,"email":"example@disqus.com"},"media":[],"isApproved":true,"dislikes":0,"raw_message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"","id":"1","thread":"1","points":1,"createdAt":"2008-06-10T01:32:08","isEdited":false,"message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"","isHighlighted":false,"ipAddress":"127.0.0.1","isSpam":false,"isDeleted":false,"likes":1},"dislikesDelta":0,"delta":0}}
Expandjson

POST vote=0&post=1

{"code":0,"response":{"vote":0,"likesDelta":0,"post":{"isJuliaFlagged":true,"isFlagged":false,"forum":"bobross","parent":null,"author":{"username":"disqus_api","about":"","name":"disqus_api","url":"","isFollowing":false,"isFollowedBy":false,"profileUrl":"http://disqus.com/disqus_api/","avatar":{"permalink":"http://disqus.com/api/users/avatars/disqus_api.jpg","cache":"http://mediacdn.disqus.com/1091/images/noavatar92.png"},"id":"1","isAnonymous":false,"email":"example@disqus.com"},"media":[],"isApproved":true,"dislikes":0,"raw_message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"","id":"1","thread":"1","points":1,"createdAt":"2008-06-10T01:32:08","isEdited":false,"message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"","isHighlighted":false,"ipAddress":"127.0.0.1","isSpam":false,"isDeleted":false,"likes":1},"dislikesDelta":0,"delta":0}}
Expandjson

POST vote=-1&post=1

{"code":0,"response":{"vote":0,"likesDelta":0,"post":{"isJuliaFlagged":true,"isFlagged":false,"forum":"bobross","parent":null,"author":{"username":"disqus_api","about":"","name":"disqus_api","url":"","isFollowing":false,"isFollowedBy":false,"profileUrl":"http://disqus.com/disqus_api/","avatar":{"permalink":"http://disqus.com/api/users/avatars/disqus_api.jpg","cache":"http://mediacdn.disqus.com/1091/images/noavatar92.png"},"id":"1","isAnonymous":false,"email":"example@disqus.com"},"media":[],"isApproved":true,"dislikes":0,"raw_message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"","id":"1","thread":"1","points":1,"createdAt":"2008-06-10T01:32:08","isEdited":false,"message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"","isHighlighted":false,"ipAddress":"127.0.0.1","isSpam":false,"isDeleted":false,"likes":1},"dislikesDelta":0,"delta":0}}
close