Reddit: Random Subreddit Actor

The Reddit: Random Subreddit Actor retrieves a paginated list of random public subreddits with rich metadata such as subscriber count, description, NSFW status, creation date, and more.

This actor is useful for:

• Discovering subreddits dynamically
• Building Reddit directory tools
• Market research and trend exploration
• Content discovery pipelines
• Seeding datasets for analytics or AI workflows

---

How It Works (High Level)

On each run, the actor:

1. Fetches a random set of subreddits

2. Applies pagination (page) and limits (limit)

3. Stores the results in:

   • Key-Value Store (OUTPUT)
   • Default Dataset (for easy export)

---

Input Configuration

Input Schema

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

Constraints

• limit: 1–100
• page: ≥ 1

Example Input

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

---

Running the Actor

You can run the actor using:

• Apify Console (UI)
• Apify API
• Apify SDK

The actor will automatically validate inputs and fail if required values are missing.

---

Output

Output Locations

The results are available in two places:

1. Key-Value Store

   • Key: OUTPUT
   • Contains the full response object

2. Dataset

   • Each run pushes the result as a dataset item
   • Ideal for CSV, JSON, or Excel exports

---

Output Structure

Top-Level Response

{
  "success": true,
  "message": "Success",
  "data": { ... },
  "error": null
}

data Object

Field	Type	Description
type	string	Result type identifier
page	number	Current page
limit	number	Requested limit
count	number	Number of subreddits returned
after	string	Pagination cursor reference
subreddits	array	List of subreddit objects

---

Subreddit Object Fields

Each item in subreddits includes:

Field	Type	Description
name	string	Subreddit name (without /r/)
title	string	Display title
description	string	Full subreddit description
subscribers	number	Subscriber count
activeUsers	number	null
created	ISO date	Subreddit creation date
nsfw	boolean	NSFW flag
language	string	Primary language
url	string	Full Reddit 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	Whether videos are allowed
allowDiscussions	boolean	null
allowDiscovery	boolean	Discoverability
isAdvertiserOnly	boolean	null

---

Example Output (Truncated)

{
  "success": true,
  "message": "Success",
  "data": {
    "page": 1,
    "limit": 25,
    "count": 25,
    "after": "t5_2qqjc",
    "subreddits": [
      {
        "name": "gadgets",
        "title": "gadgets",
        "subscribers": 22750688,
        "nsfw": false,
        "language": "en",
        "url": "https://reddit.com/r/gadgets/",
        "created": "2007-09-17T18:42:33.000Z"
      }
    ]
  },
  "error": null
}

---

Pagination Behavior

• Pagination is page-based
• Increase the page value to fetch more results
• Each page returns a new randomized set

Example:

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

---

Error Handling

If an error occurs:

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

Error Example

{
  "data": null,
  "error": "limit and page are required in the input",
  "timestamp": "2026-01-09T12:34:56.789Z"
}

---

Best Practices

• Use smaller limits (e.g. 25–50) for faster runs
• Export the dataset for bulk processing
• Cache results if running frequently
• Combine with other Reddit actors for deeper analysis

---

Summary

✅ Fetches random subreddits ✅ Fully paginated ✅ Rich metadata ✅ Dataset + Key-Value output ✅ Ready for automation and analytics

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