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