Browse Reddit's Default Subreddits

Browse Reddit's default front-page set of subreddits, no keyword needed. Returns a subreddits listing with a cursor, for community discovery.

GET/api/reddit/subreddits/default$0.002 / call

Browse Reddit's default front-page set of subreddits, without a keyword. Returns a subreddits list (each item is the same shape as /api/reddit/sub/:name/about) plus an after cursor. One read.

When to use this

Reach for this to see what a logged-out visitor's front page is built from: the baseline communities Reddit surfaces by default. This BROWSES communities; to SEARCH communities by keyword use /api/reddit/search/communities.

Query Parameters

Parameter	Type	Required	Description
`limit`	number	No	Number of subreddits to return, `1`-`100` (default `25`)
`after`	string	No	Pagination cursor. Pass back the `after` value from the previous response exactly as issued; it is opaque and carries your paging depth. See Pagination depth.

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/api/reddit/subreddits/default?limit=25"

const response = await fetch(
  "https://api.redditapis.com/api/reddit/subreddits/default?limit=25",
  { headers: { Authorization: "Bearer TOKEN" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.redditapis.com/api/reddit/subreddits/default",
    params={"limit": 25},
    headers={"Authorization": "Bearer TOKEN"},
)

Response Shape

{
  "subreddits": [
    {
      "name": "funny",
      "id": "2qh33",
      "fullname": "t5_2qh33",
      "title": "funny",
      "display_name_prefixed": "r/funny",
      "public_description": "Reddit's largest humour depository.",
      "description": "...",
      "subscribers": 40000000,
      "active_user_count": 15000,
      "created_utc": 1201261935,
      "created": "2008-01-25T12:32:15.000Z",
      "over_18": false,
      "subreddit_type": "public",
      "url": "/r/funny/",
      "lang": "en",
      "icon_img": "https://b.thumbs.redditmedia.com/...png",
      "banner_img": "https://styles.redditmedia.com/...png"
    }
  ],
  "after": "t5_2qh33"
}

Response Fields

Field	Type	Notes
`subreddits`	array	The community listing (each item as below)
`after`	string \| null	Cursor for the next page, or `null` when there is no next page to request. An empty cursor does not always mean you have every item, so read `listing_status` (below) to find out which. See Pagination depth.
`name`	string	Subreddit name (the `display_name`, no `r/` prefix)
`id`	string	Subreddit id without prefix
`fullname`	string	Full id with the `t5_` prefix
`title`	string	Subreddit title
`display_name_prefixed`	string	The `r/name` form
`public_description`	string	Short public blurb
`description`	string \| null	Full sidebar description (markdown)
`subscribers`	number	Subscriber count
`active_user_count`	number \| null	Users online now (Reddit often omits this, may be `null`)
`created_utc`	number	Unix epoch seconds
`created`	string \| null	ISO-8601 form of `created_utc`
`over_18`	boolean \| null	`true` if the subreddit is NSFW
`subreddit_type`	string	`public` \| `restricted` \| `private` \| ...
`url`	string	Subreddit path, e.g. `/r/funny/`
`lang`	string \| null	Primary language code (e.g. `en`)
`icon_img`	string \| null	Community icon URL (may be empty / `null`)
`banner_img`	string \| null	Banner image URL (may be empty / `null`)

When `after` comes back empty

An empty cursor means there is no next page to ask for. It does not always mean you have every subreddit: Reddit often stops serving a busy listing long before it runs out. Paging r/all on 2026-08-14 stopped after 400 posts covering about a minute of a feed that plainly holds more.

The response tells you which happened. When after is null it also carries listing_status, which reads complete, truncated or unknown. Only complete means you have everything; treat the other two as a partial answer and widen your search rather than stopping. The full field list and what to do about each answer is in Pagination depth.

Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.