API Documentation

categories/listThreads

Returns a list of threads within a category sorted by the date created.

URL

https://disqus.com/api/3.0/categories/listThreads.json

Accessibility

public key, secret key

Supported request methods

GET

Supported formats

json, jsonp, rss

Requires authentication

no

Rate limited

inherits global rate limit

Arguments

Required

  • category

    Looks up a category by ID

Optional

  • since

    Defaults to null

    Unix timestamp (or ISO datetime standard)

  • related allows multiple

    Defaults to []

    You may specify relations to include with your response.
    Choices: forum, author

  • cursor

    Defaults to null

  • limit

    Defaults to 25

    Maximum value of 100

  • order

    Defaults to "desc"

    Choices: asc, desc

Example Responses

Expand json

GET category=1

{
  "cursor": {
    "prev": null,
    "hasNext": false,
    "next": "1213061503000000:1:0",
    "hasPrev": false,
    "total": null,
    "id": "1213061503000000:1:0",
    "more": false
  },
  "code": 0,
  "response": [
    {
      "category": "1",
      "reactions": 0,
      "identifiers": [],
      "forum": "bobross",
      "title": "Donkeys live a long time",
      "dislikes": 0,
      "isDeleted": false,
      "author": "1",
      "userScore": 0,
      "id": "2",
      "isClosed": false,
      "posts": 0,
      "link": null,
      "likes": 0,
      "message": "\"Donkeys live a long time. None of you have ever seen a dead donkey.\"",
      "ipAddress": "127.0.0.1",
      "slug": "donkeys_live_a_long_time",
      "createdAt": "2008-06-10T02:31:43"
    },
    {
      "category": "1",
      "reactions": 0,
      "identifiers": [
        "my-identifier"
      ],
      "forum": "bobross",
      "title": "Happy Accidents",
      "dislikes": 0,
      "isDeleted": false,
      "author": "1",
      "userScore": 0,
      "id": "1",
      "isClosed": false,
      "posts": 151,
      "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"
    }
  ]
}