Reddit: Subreddit Information

This Apify Actor retrieves public metadata and details about a Reddit subreddit based on its URL.

The actor is read-only and does not require authentication.

---

What This Actor Does

Given a valid Reddit subreddit URL, the actor returns structured information about the subreddit, including:

• Subreddit name and title
• Description and rules text
• Subscriber count
• Creation date
• NSFW status
• Language
• Icons and banners
• Submission settings and moderation flags

---

Input

The actor accepts a JSON input object with the following properties.

Input Schema

Field	Type	Required	Description
subredditUrl	string	✅ Yes	Full Reddit subreddit URL (e.g. https://www.reddit.com/r/wallstreet)

⚠️ Note: Although limit, page, and sortBy are required by the input schema, they are not used in the subreddit information operation. You can keep their default values.

---

Example Input

{
  "subredditUrl": "https://www.reddit.com/r/wallstreet" 
}

---

Output

The actor stores the result in two places:

• Key-Value Store under the key OUTPUT
• Dataset (each run pushes one result object)

Output Structure

{
  "success": true,
  "message": "Success",
  "data": {
    "name": "string",
    "title": "string",
    "description": "string",
    "subscribers": number,
    "activeUsers": number | null,
    "created": "ISO-8601 date string",
    "nsfw": boolean,
    "language": "string",
    "url": "string",
    "icon": "string | null",
    "banner": "string | null",
    "submitText": "string | null",
    "isQuarantined": boolean,
    "communityReviewed": boolean | null,
    "allowVideos": boolean | null,
    "allowDiscussions": boolean | null,
    "allowDiscovery": boolean | null,
    "isAdvertiserOnly": boolean | null
  },
  "error": null
}

---

Example Output

{
  "success": true,
  "message": "Success",
  "data": {
    "name": "wallstreet",
    "title": "Wall Street",
    "description": "Get Money.\n\nDiscord: ...",
    "subscribers": 87323,
    "activeUsers": null,
    "created": "2010-03-21T15:12:40.000Z",
    "nsfw": false,
    "language": "en",
    "url": "https://reddit.com/r/wallstreet/",
    "icon": "https://...png",
    "banner": "https://...png",
    "submitText": "Please properly mark links...",
    "isQuarantined": false,
    "communityReviewed": true,
    "allowVideos": true,
    "allowDiscussions": null,
    "allowDiscovery": true,
    "isAdvertiserOnly": null
  },
  "error": null
}

---

Error Handling

If the input URL is invalid or the subreddit cannot be processed, the actor will:

• Throw an execution error
• Push an error object to the dataset

Error Output Example

{
  "data": null,
  "error": "The provided subredditUrl is not a valid Reddit subreddit URL",
  "timestamp": "2026-01-09T12:34:56.789Z"
}

---

Valid Subreddit URL Formats

The actor accepts standard Reddit subreddit URLs, such as:

• https://www.reddit.com/r/{subreddit}
• https://reddit.com/r/{subreddit}

Invalid or non-subreddit URLs will cause the run to fail.

---

Typical Use Cases

• Market research on Reddit communities
• Tracking subreddit growth and metadata
• Content moderation analysis
• Community discovery and analytics
• Feeding subreddit metadata into dashboards or APIs

---

Notes

• Public data only (no login required)
• One subreddit per run
• Safe to automate and schedule

---

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