API Documentation

categories/list

Returns a list of categories within a forum.

URL

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

Accessibility

public key, secret key

Supported request methods

GET

Supported formats

json, jsonp

Requires authentication

no

Rate limited

inherits global rate limit

Arguments

Optional

  • forum allows multiple

    Defaults to null

    Looks up a forum by ID (aka short name)

  • since_id

    Defaults to null

  • cursor

    Defaults to null

  • limit

    Defaults to 25

    Maximum value of 100

  • order

    Defaults to "asc"

    Choices: asc, desc

Example Responses

Expand json

GET forum=bobross

{
  "cursor": {
    "prev": null,
    "hasNext": false,
    "next": "1:25:0",
    "hasPrev": false,
    "total": null,
    "id": "1:25:0",
    "more": false
  },
  "code": 0,
  "response": [
    {
      "id": "1",
      "forum": "bobross",
      "order": 0,
      "isDefault": true,
      "title": "General"
    }
  ]
}