Reddit: Random Subreddit Actor

Pricing

Rating

Developer

Actor stats

Categories

Share

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

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

Subreddit Object Fields

Each item in subreddits includes:

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