Subreddits

listSubreddits(options?): Listing<Subreddit>

GET

https://api.threadapi.dev/v1/reddit/subreddits

1 Credit

Lists Reddit's popular subreddits, or the newest ones. To find subreddits about a topic, use Search with type=subreddit. 1 credit per page of up to 100 subreddits; see Listings and pages.

Security

API Key

All requests require a valid API key from the developer dashboard.

Headers: Authorization: Bearer YOUR_API_KEYorX-API-Key: YOUR_API_KEY

See Authentication for headers and rate limits.

Query parameters

Parameter	Type	Required	Description
`sort`query	`string`	No	`popular` (default) or `new`.
`limit`query	`integer`	No	Subreddits per page, 1 to 100. Default `25`.
`after`query	`string`	No	The previous page's `after`, for the next page.
`nsfw`query	`boolean`	No	Include subreddits marked NSFW. Default `false`.

Response

{
  "subreddit": null,
  "query": null,
  "sort": "popular",
  "count": 3,
  "items": [
    {
      "name": "Home",
      "title": "Home",
      "public_description": "",
      "description": "Everything home related: interior design, home improvement, architecture.\n\n…",
      "subscribers": 432839,
      "created_at": "2009-01-25T02:25:57Z",
      "over_18": false,
      "type": "public",
      "url": "/r/Home/"
    }
  ],
  "after": "t5_2w844",
  "filtered_nsfw": 0
}

Items have the fields of Subreddit about without the rules.