Reddit Explore API - Browse Communities by Topic
FetchLayer fetchlayer.dev Sign in

Browse communities grouped by topic

Explore subreddits organized by topic/category. Returns a curated list of communities across different interests.

POST /explore Discover
https://api.fetchlayer.dev/reddit/explore
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

topic string | null optional

Optional Reddit explore topic filter.

Response Fields

explore

Browse communities grouped by topic

blocked boolean

Whether Reddit returned a block or verification page.

blockReason string | null

Machine-readable block reason when blocked is true; otherwise omitted.

blockedBodyText string | null

Diagnostic block-page text when blocked is true; otherwise omitted.

pageTitle string

Title of the scraped Reddit page.

requestedUrl string

Reddit URL requested by the scraper.

fetchUrl string

Normalized Reddit URL fetched by the scraper.

finalUrl string

Final URL after redirects.

responseStatus number | null

HTTP status returned by Reddit, or null when unavailable.

listingType string

Always explore for a successful response.

sections[].heading string

Explore section heading.

sections[].items[].subreddit string | null

Subreddit name without the r/ prefix.

sections[].items[].subredditPrefixed string | null

Subreddit name with the r/ prefix.

sections[].items[].subredditId string | null

Reddit subreddit ID.

sections[].items[].title string | null

Community title.

sections[].items[].descriptionText string

Plain-text community description.

sections[].items[].iconUrl string | null

Community icon URL.

sections[].items[].url string | null

Absolute subreddit URL.

sections[].items[].weeklyVisitorsText string | null

Weekly visitors text displayed by Reddit.

allItems[].subreddit string | null

Subreddit name without the r/ prefix.

allItems[].subredditPrefixed string | null

Subreddit name with the r/ prefix.

allItems[].subredditId string | null

Reddit subreddit ID.

allItems[].title string | null

Community title.

allItems[].descriptionText string

Plain-text community description.

allItems[].iconUrl string | null

Community icon URL.

allItems[].url string | null

Absolute subreddit URL.

allItems[].weeklyVisitorsText string | null

Weekly visitors text displayed by Reddit.

totalItemCount number

Total number of communities in allItems.

topics[] string

Available explore topic filters.

scrapedAt string

ISO 8601 timestamp for the scrape.

transport string

Reddit page transport used for extraction.

Request

curl -X POST "https://api.fetchlayer.dev/reddit/explore" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"topic":"technology"}'

Response

{
  "blocked": false,
  "listingType": "explore",
  "sections": [
    {
      "heading": "Technology",
      "items": [
        {
          "subreddit": "programming",
          "subredditPrefixed": "r/programming",
          "subredditId": "t5_2fwo",
          "title": "Programming",
          "descriptionText": "Computer Programming",
          "url": "https://www.reddit.com/r/programming/"
        }
      ]
    }
  ],
  "allItems": [],
  "totalItemCount": 1,
  "topics": [
    "Technology"
  ],
  "transport": "new-reddit-html"
}