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