API Documentation

trends/listThreads

Returns a list of trending threads.

URL

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

Optional

  • limit

    Defaults to 10

    Maximum value of 10

  • related allows multiple

    Defaults to []

    You may specify relations to include with your response.
    Choices: forum, author, category

  • forum allows multiple

    Defaults to null

    Looks up a forum by ID (aka short name)

Example Responses

Expand json

GET forum=bobross

{
  "code":0,
  "response":[
    {
      "thread":{
        "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"
      },
      "postLikes":0,
      "posts":0,
      "score":0,
      "link":null,
      "likes":0
    },
    {
      "thread":{
        "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":4,
        "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"
      },
      "postLikes":1,
      "posts":4,
      "score":0,
      "link":null,
      "likes":0
    }
  ]
}