API Documentation

threads/list

Returns a list of threads sorted by the date created.

URL

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

Optional

  • category allows multiple

    Defaults to null

    Looks up a category by ID

  • forum allows multiple

    Defaults to null

    Looks up a forum by ID (aka short name)

  • thread allows multiple

    Defaults to null

    Looks up a thread by ID
    You may pass us the 'ident' query type instead of an ID by including 'forum'.
    You may pass us the 'link' query type to filter by URL. You must pass the 'forum' if you do not have the Pro API Access addon.

  • author allows multiple

    Defaults to null

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

  • 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, category

  • cursor

    Defaults to null

  • attach allows multiple

    Defaults to []

    Choices: topics

  • limit

    Defaults to 25

    Maximum value of 100

  • include allows multiple

    Defaults to [ "open", "closed" ]

    Choices: open, closed, killed

  • order

    Defaults to "desc"

    Choices: asc, desc

Example Responses

Expand json

GET forum=bobross

{
  "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":76,
      "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"
    }
  ]
}
Expand json

GET related=author&forum=bobross

{
  "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":{
        "username":"disqus_api",
        "about":"",
        "name":"disqus_api",
        "url":"",
        "isFollowing":false,
        "isFollowedBy":false,
        "profileUrl":"http://disqus.com/disqus_api/",
        "avatar":{
          "permalink":"http://disqus.com/api/users/avatars/disqus_api.jpg",
          "cache":"http://mediacdn.disqus.com/1091/images/noavatar92.png"
        },
        "id":"1",
        "isAnonymous":false,
        "email":"example@disqus.com"
      },
      "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":{
        "username":"disqus_api",
        "about":"",
        "name":"disqus_api",
        "url":"",
        "isFollowing":false,
        "isFollowedBy":false,
        "profileUrl":"http://disqus.com/disqus_api/",
        "avatar":{
          "permalink":"http://disqus.com/api/users/avatars/disqus_api.jpg",
          "cache":"http://mediacdn.disqus.com/1091/images/noavatar92.png"
        },
        "id":"1",
        "isAnonymous":false,
        "email":"example@disqus.com"
      },
      "userScore":0,
      "id":"1",
      "isClosed":false,
      "posts":79,
      "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"
    }
  ]
}