Reddit: New Subreddit Actor

Overview

Reddit: New Subreddit Actor retrieves newly created subreddits from Reddit using pagination. It is useful for:

• Discovering newly created communities
• Market research & trend analysis
• Monitoring niche creation on Reddit
• Data analysis and automation workflows

The actor returns structured data including subreddit metadata such as name, description, creation date, subscribers, NSFW status, and more.

---

How It Works (User Perspective)

You provide:

• A page number
• A limit (number of subreddits per page)

The actor:

• Fetches newly created subreddits
• Returns a paginated result
• Stores data in both Dataset items and OUTPUT

---

Input Configuration

Input Schema

Field	Type	Required	Default	Description
limit	Integer	✅ Yes	25	Number of subreddits to return per page (1–100)
page	Integer	✅ Yes	1	Page number to retrieve (1-based)

Input Constraints

• limit: minimum 1, maximum 100
• page: minimum 1
• Both fields are mandatory

Example Input

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

---

Running the Actor

You can run the actor using:

• Apify Console (UI)
• Apify API
• Apify SDK automation workflows
• Scheduled runs

Just provide the input values and start the run.

---

Output

Where the Data Is Stored

The actor saves results in two places:

1. Dataset – each run pushes the result data

2. Key-Value Store

   • Key: OUTPUT
   • Value: Full response object

---

Output Structure

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

---

Root Fields

Field	Type	Description
success	Boolean	Indicates if the request succeeded
message	String	Status message
data	Object	Main response payload
error	String	null

---

data Object

Field	Type	Description
type	String	Always "new"
page	Number	Current page
limit	Number	Items per page
count	Number	Number of subreddits returned
after	String	Reddit pagination cursor
subreddits	Array	List of subreddit objects

---

Subreddit Object Fields

Each subreddit entry contains:

Field	Type	Description
name	String	Subreddit name
title	String	Display title
description	String	Subreddit description
subscribers	Number	Subscriber count
activeUsers	Number	null
created	ISO Date	Creation timestamp
nsfw	Boolean	NSFW flag
language	String	Detected language
url	String	Full subreddit URL
icon	String	Icon image URL
banner	String	Banner image URL
submitText	String	Submission rules text
isQuarantined	Boolean	Quarantine status
communityReviewed	Boolean	Community review status
allowVideos	Boolean	Video posts allowed
allowDiscussions	Boolean	null
allowDiscovery	Boolean	Discoverability status
isAdvertiserOnly	Boolean	null

---

Example Subreddit Entry

{
  "name": "Falconbseries",
  "title": "Falconbseries",
  "description": "we talk about the falcon b series a masterpiece of a car",
  "subscribers": 1,
  "activeUsers": null,
  "created": "2026-01-09T13:58:33.000Z",
  "nsfw": false,
  "language": "en",
  "url": "https://reddit.com/r/Falconbseries/",
  "icon": "",
  "banner": "",
  "submitText": "",
  "isQuarantined": false,
  "communityReviewed": false,
  "allowVideos": true,
  "allowDiscussions": null,
  "allowDiscovery": true,
  "isAdvertiserOnly": null
}

---

Error Handling

If an error occurs:

• The run fails
• An error object is pushed to the Dataset
• error field contains the message

Example Error Output

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

---

Pagination Strategy

To fetch more subreddits:

1. Start with page = 1
2. Increment page for subsequent requests
3. Keep the same limit for consistent pagination

Example:

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

---

Use Cases

• Track newly created subreddits daily
• Identify emerging Reddit communities
• Feed data into analytics dashboards
• Automate niche discovery workflows

---

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