API Documentation

forums/listThreads

Returns a list of threads within a forum sorted by the date created.

URL

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

Required

  • forum

    Looks up a forum by ID (aka short name)

Optional

  • after

    Defaults to null

    Unix timestamp (or ISO datetime standard)

  • 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.

  • 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

  • cursor

    Defaults to null

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