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

Required

  • forum allows multiple

    Looks up a forum by ID (aka short name)

Optional

  • 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"
    }
  ]
}