API Documentation

users/listForums

Returns a list of forums a user owns.

URL

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

  • since_id

    Defaults to null

  • cursor

    Defaults to null

  • limit

    Defaults to 25

    Maximum value of 100

  • user

    Defaults to null

    Looks up a user by ID
    You may look up a user by username using the 'username' query type.

  • order

    Defaults to "asc"

    Choices: asc, desc

Example Responses

Expand json

GET

List forums owned by the authenticated user.

{
  "cursor":{
    "prev":null,
    "hasNext":false,
    "next":"1:25:0",
    "hasPrev":false,
    "total":null,
    "id":"1:25:0",
    "more":false
  },
  "code":0,
  "response":[
    {
      "id":"bobross",
      "name":"Bob Ross",
      "founder":"1",
      "favicon":{
        "permalink":"http://disqus.com/api/forums/favicons/bobross.jpg",
        "cache":"http://mediacdn.disqus.com/1091/images/favicon-default.png"
      }
    }
  ]
}
Expand json

GET user=1

{
  "cursor":{
    "prev":null,
    "hasNext":false,
    "next":"1:25:0",
    "hasPrev":false,
    "total":null,
    "id":"1:25:0",
    "more":false
  },
  "code":0,
  "response":[
    {
      "id":"bobross",
      "name":"Bob Ross",
      "founder":"1",
      "favicon":{
        "permalink":"http://disqus.com/api/forums/favicons/bobross.jpg",
        "cache":"http://mediacdn.disqus.com/1091/images/favicon-default.png"
      }
    }
  ]
}