API Documentation

threads/listPopular Beta

This method is currently under development and subject to change.

Returns a list of threads sorted by number of posts made since ``interval``.

If you are using both ``category`` and ``forum`` parameters, the forum of the category
must match that as the parameter value for ``forum``.




public key, secret key

Supported request methods


Supported formats

json, jsonp, rss

Requires authentication


Rate limited

inherits global rate limit



  • category

    Defaults to null

    Looks up a category by ID

  • interval

    Defaults to "7d"

    Choices: 1h, 6h, 12h, 1d, 3d, 7d, 30d, 90d

  • forum

    Defaults to null

    Looks up a forum by ID (aka short name)

  • related allows multiple

    Defaults to []

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

  • limit

    Defaults to 25

    Maximum value of 100

  • with_top_post

    Defaults to false

Example Responses

Expand json

GET forum=bobross