API Documentation

threads/vote

Register a vote on a thread.

URL

https://disqus.com/api/3.0/threads/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

  • thread

    Looks up a thread by ID
    You may pass use the 'ident' or 'link' query types instead of an ID by including 'forum'.

Optional

  • forum

    Defaults to null

    Looks up a forum by ID (aka short name)

Example Responses

Expand json

POST vote=1&thread=1

{
  "code": 0,
  "response": {
    "likesDelta": 1,
    "vote": 1,
    "dislikesDelta": -1,
    "thread": {
      "category": "1",
      "reactions": 0,
      "identifiers": [
        "my-identifier"
      ],
      "forum": "bobross",
      "title": "Happy Accidents",
      "dislikes": 0,
      "isDeleted": false,
      "author": "1",
      "userScore": 1,
      "id": "1",
      "isClosed": false,
      "posts": 130,
      "link": null,
      "likes": 1,
      "message": "\"If you've painted before you know that we don't make mistakes -- we have happy accidents.\"",
      "ipAddress": "127.0.0.1",
      "slug": "happy_accidents",
      "createdAt": "2008-06-10T01:31:43"
    },
    "delta": 1
  }
}
Expand json

POST vote=-1&thread=1

{
  "code": 0,
  "response": {
    "likesDelta": -1,
    "vote": -1,
    "dislikesDelta": 1,
    "thread": {
      "category": "1",
      "reactions": 0,
      "identifiers": [
        "my-identifier"
      ],
      "forum": "bobross",
      "title": "Happy Accidents",
      "dislikes": 1,
      "isDeleted": false,
      "author": "1",
      "userScore": -1,
      "id": "1",
      "isClosed": false,
      "posts": 133,
      "link": null,
      "likes": 0,
      "message": "\"If you've painted before you know that we don't make mistakes -- we have happy accidents.\"",
      "ipAddress": "127.0.0.1",
      "slug": "happy_accidents",
      "createdAt": "2008-06-10T01:31:43"
    },
    "delta": -1
  }
}
Expand json

POST vote=1&thread:ident=my-identifier&forum=bobross

{
  "code": 0,
  "response": {
    "likesDelta": 1,
    "vote": 1,
    "dislikesDelta": -1,
    "thread": {
      "category": "1",
      "reactions": 0,
      "identifiers": [
        "my-identifier"
      ],
      "forum": "bobross",
      "title": "Happy Accidents",
      "dislikes": 0,
      "isDeleted": false,
      "author": "1",
      "userScore": 1,
      "id": "1",
      "isClosed": false,
      "posts": 136,
      "link": null,
      "likes": 1,
      "message": "\"If you've painted before you know that we don't make mistakes -- we have happy accidents.\"",
      "ipAddress": "127.0.0.1",
      "slug": "happy_accidents",
      "createdAt": "2008-06-10T01:31:43"
    },
    "delta": 1
  }
}