Reddit: Trending Subreddit Actor

The Reddit: Trending Subreddit Actor allows you to retrieve a paginated list of trending/popular subreddits from Reddit, including rich metadata such as subscriber counts, descriptions, NSFW status, creation date, and more.

This actor is ideal for:

• Market research
• Trend analysis
• Content discovery
• Social media monitoring
• Data enrichment pipelines

---

🚀 How It Works

You provide pagination parameters (limit and page), and the actor returns a structured list of trending subreddits for that page.

The results are:

• Stored in the default dataset
• Saved under the OUTPUT key for easy retrieval

---

🔧 Input Parameters

The actor expects a JSON input with the following fields:

Input Schema

Field	Type	Required	Description
limit	integer	✅ Yes	Number of subreddits to return per page
page	integer	✅ Yes	Page number to fetch (1-based index)

Constraints

• limit: minimum 1, maximum 100
• page: minimum 1

Default Values

{
  "limit": 25,
  "page": 1
}

---

📝 Example Input

{
  "limit": 25,
  "page": 1
}

---

📤 Output

The actor returns a JSON object describing the requested page of trending subreddits.

Output Structure

{
  "success": true,
  "message": "Success",
  "data": {
    "type": "popular",
    "page": 1,
    "limit": 25,
    "count": 25,
    "after": "t5_2cneq",
    "subreddits": [ ... ]
  },
  "error": null
}

---

📊 Output Fields Explained

Root Fields

Field	Type	Description
success	boolean	Indicates if the request was successful
message	string	Status message
data	object	Main payload with subreddit data
error	string	null

---

data Object

Field	Type	Description
type	string	Type of listing (popular)
page	number	Current page number
limit	number	Items requested per page
count	number	Number of subreddits returned
after	string	Pagination cursor
subreddits	array	List of subreddit objects

---

subreddits Object

Each subreddit contains the following fields:

Field	Type	Description
name	string	Subreddit name
title	string	Display title
description	string	Full subreddit description
subscribers	number	Total subscribers
activeUsers	number	null
created	string (ISO)	Creation date
nsfw	boolean	NSFW flag
language	string	Detected language
url	string	Subreddit URL
icon	string	Icon image URL
banner	string	Banner image URL
submitText	string	Submission guidelines
isQuarantined	boolean	Quarantine status
communityReviewed	boolean	Community review status
allowVideos	boolean	Video posting enabled
allowDiscussions	boolean	null
allowDiscovery	boolean	Discoverability enabled
isAdvertiserOnly	boolean	null

---

📦 Dataset & Storage

• All results are pushed to the default Apify dataset
• The full response is also stored under the key:

OUTPUT

You can retrieve it via:

• Apify Console
• Apify API
• Apify SDK (Actor.getValue('OUTPUT'))

---

⚠️ Error Handling

If an error occurs:

• The actor fails execution
• An error record is pushed to the dataset

Error Output Example

{
  "data": null,
  "error": "limit and page are required in the input",
  "timestamp": "2026-01-09T10:15:30.000Z"
}

---

✅ Best Practices

• Use smaller limit values for faster pagination
• Increment page to retrieve more trending subreddits
• Combine with scheduled runs to track trends over time

---

📌 Summary

• ✔ Fetch trending Reddit subreddits
• ✔ Paginated and structured output
• ✔ Rich metadata per subreddit
• ✔ Easy dataset and OUTPUT access

---

Support

For issues, questions, or feature requests, please refer to the Apify platform documentation or:

1. Create an issue and share your resource
2. Send us private message
3. Contact us via Telegram: @pintoflow