Reddit Subreddits V2

Sixteen self-contained subreddit lookups — ID, rules, access state, type / topic, chat channels, flairs, custom emojis, theme & widgets, highlighted posts, status, wiki, plus the 5 bearer-only endpoints the Android app uses (access eligibility, full mod-side settings, post requirements, top-poster leaderboard, top-commenter leaderboard).

The first 11 endpoints are anonymous — no Reddit account, no OAuth, no proxy required. The 5 bearer endpoints reuse a Reddit account you've already saved in the Reddit Vault actor (or you can paste a Token V2 + matching proxy directly).

Pick an endpoint, fill the matching section, hit Start.

---

What you can fetch

Every endpoint accepts a subreddit in any of these formats — paste whichever you have:

• bare name — AskReddit
• prefixed — r/AskReddit
• subreddit URL — https://www.reddit.com/r/AskReddit
• old-Reddit URL — https://old.reddit.com/r/AskReddit

Public endpoints (no Reddit account needed)

1. ID — resolve subreddit name to its t5_ ID

The simplest endpoint. Takes a subreddit name and returns Reddit's internal t5_... ID.

Returns: id (t5_...), name, prefixedName (r/...).

Use it when: you need a subreddit ID to seed another endpoint that takes IDs (e.g., the Recommended Media feed in Reddit Feeds V2, or any of Reddit's bulk-by-ID lookups).

2. Rules — community rules list

Returns the subreddit's published rules — the list shown in the sidebar / community page.

Returns: array of rules, each with priority, name (short name), description, violationReason, kind (link / comment / all), createdAt.

Use it when: moderation tooling, rule-based content classification, building a "before you post" UX, or compliance / content-policy auditing.

3. Access Info — public / restricted / private + age gate

Tells you whether the subreddit is public, restricted, or private — and whether content is age-gated (NSFW).

Returns: isContributorRequired (restricted-mode flag), isNsfw (over-18 flag), isQuarantined, subscribersCount, permissions (what an anonymous viewer can do).

Use it when: filtering content collection (skip private / quarantined subs), bulk-checking accessibility before scraping, NSFW-policy enforcement.

4. Type — community type & topic settings

Returns Reddit's type-classification settings for the subreddit — what kind of community it is, what posts it allows, what topic it's tagged under.

Returns: type (public / restricted / private / employees_only), topic (Reddit's interest-topic tag), allowedPostTypes (text / link / image / video / poll / gallery), language, country, originalContentTagEnabled.

Use it when: community taxonomy, building targeting rules ("only image-allowed gaming subs in EN"), audience research.

5. Channels — chat channels enabled flag

Returns whether the subreddit has Reddit chat channels enabled.

Returns: chatChannelsEnabled flag plus channel metadata if any.

Use it when: mapping which subreddits have an active Reddit Chat surface, community-engagement audits.

6. Flairs — searchable flairs (post + user)

Returns the full list of post flairs and user flairs the subreddit has configured.

Returns: two arrays — postFlairs (with id, text, cssClass, backgroundColor, textColor, richtext, mod-only flag) and userFlairs (same shape).

Use it when: flair-aware scraping (filter posts by flair), building a flair picker for a posting actor, content classification using subreddit-defined tags.

7. Emojis — custom emoji list (snoomoji + community)

Returns the subreddit's custom emoji set — the community-uploaded emojis used in flairs and comments.

Returns: array of emojis, each with name, url (image URL), mod-only flag, userFlairAllowed flag, postFlairAllowed flag, createdAt.

Use it when: rendering subreddit content with proper emoji assets, building emoji catalogs for a UI, monitoring custom-emoji adoption.

8. Style & Widgets — colors, banners, sidebar widgets

The full visual identity payload — theme colors, banner / icon imagery, and the sidebar widgets Reddit shows on the community page (rules block, mod list, custom widgets, calendar, button widgets, image widgets, etc.).

Returns: style (banner image, icon, mobile banner, primary color, banner background color), plus widgets (id-keyed map of every widget on the sidebar with its kind and content).

Use it when: asset extraction, building a community-aware UI, embedding subreddit branding in a downstream app, design-research / community-aesthetics analysis.

9. Highlights — highlighted posts on community page

Returns the posts the subreddit's mods have highlighted / pinned to the community page (the "Pinned" section at the top).

Returns: array of post records — same field shape as Reddit Feeds V2 (id, postTitle, score, commentCount, createdAt, url, flair, etc.).

Note: Many subreddits have no highlighted posts. An empty list is the normal result when the mods haven't pinned anything.

Use it when: featured-content discovery, finding the rules / mod-announcement pinned posts, monitoring community campaigns.

10. Status — community status flags

Returns the lifecycle / visibility state of the subreddit — whether it is currently active, archived, locked, deleted, banned, or quarantined.

Returns: isActive, isArchived, isLocked, isDeleted, isBanned, isQuarantined, plus the human-readable reason / message Reddit displays for unavailable communities.

Use it when: screening dead / banned / archived subs out of a target list before launching a scrape, monitoring health of communities you depend on, dashboards that show which subs went down.

11. Wiki — wiki page content

Reads the markdown content of any wiki page on the subreddit. Defaults to the wiki index, but you can pick from a dropdown of the most common pages.

Inputs:

• Subreddit — same input as everywhere else
• Wiki page — one of index (default), config/sidebar, config/description, config/submit_text, faq, rules, wiki

Returns: content (the page's markdown body), revisionDate, revisionAuthor, mayRevise (whether the current viewer can edit — always false for anonymous reads), pageName.

Use it when: scraping FAQ / sidebar / rules-as-prose, archiving wiki history, building a chat-bot grounded on a community's wiki.

Note on wiki vs index: these are usually the same page. index is the canonical name; wiki is what some communities use as the entry point.

Bearer-required endpoints (need a Reddit account)

These five endpoints hit GraphQL queries Reddit only serves to authenticated users. Fill the Reddit credentials section at the bottom of the input form (see Credentials below).

12. Access Eligibility — gating + age / quarantine state

Reddit's Android-app gating call: tells you, for the signed-in user, whether they can access this subreddit and what gate (age verification, quarantine ack, NSFW opt-in, contributor requirement) is currently blocking them.

Returns: eligibility (allowed / blocked), gate (e.g. age_verification, quarantined, nsfw_opt_in, contributors_only), acknowledgmentRequired, messageHtml (the modal text Reddit would show in-app).

Use it when: building a sign-in / browse flow that has to handle the same gates the Reddit app shows; pre-checking before a scraper authenticated as a user tries to read content; dashboards that surface "this account can / can't reach sub X".

13. Settings — full mod-side settings

Returns the full Settings payload Reddit returns to a user with mod permissions on the subreddit — the exact fields the mod tools page edits. Many fields are also visible to non-mods (read-only); a non-mod call still returns the public subset.

Returns: name, description, publicDescription, submitText, submitTextLabel, submitLinkLabel, language, country, subredditType, wikiEditMode, wikiEditAge, wikiEditKarma, spoilerEnabled, allOriginalContent, originalContentTagEnabled, welcomeMessageEnabled, welcomeMessageText, plus content-control flags (isCommentScoreHideMinsEnabled, commentScoreHideMins, suggestedCommentSort, etc.).

Use it when: building mod tooling, exporting / migrating a community config, snapshot-diffing your settings over time, auditing a subreddit you own.

14. Post Requirements — title / body rules + allowed types

Returns the per-subreddit posting rules Reddit enforces server-side — what title length is allowed, which body types (text / link / image / video) are accepted, whether flair is required, banned domains, banned words, repost windows.

Returns: titleRequired, titleBlacklistedRegex, titleRegex, bodyRequired, bodyBlacklistedRegex, bodyRegex, bodyRestrictionPolicy, bodyTextMinLength, bodyTextMaxLength, linkRequired, linkRestrictionPolicy, domainBlacklist, domainWhitelist, flairRequired, repostAge, linkRepostProtection, imageRepostProtection.

Use it when: validating user-supplied post content before you submit through any of the posting actors (saves you a failed submission), building a "post-prep" UI, audit-trailing why a community auto-removes posts.

15. Top Posters — community leaderboard, top posters

Returns the leaderboard Reddit's Android app shows in "Top Contributors → Posters". Reddit splits these contributors into tiers (gold / silver / bronze plus an honorable-mentions tail).

Inputs (optional):

• Max users — 1 to 1000 (default 100). Higher values use more API calls (paginated 25 / page server-side).

Returns: tiers (top tier blocks with their slot caps and contributors), users (flat list of all returned contributors with username, avatar, score, rank, tierName), count, has_more.

Use it when: finding the most active posters in a community, sourcing power-users for outreach, ranking communities by contributor concentration.

16. Top Commenters — community leaderboard, top commenters

Same payload shape as Top Posters but for the commenters leaderboard.

Inputs (optional):

• Max users — 1 to 1000 (default 100).

Returns: identical to Top Posters but ranking is by comment activity.

Use it when: finding most active commenters for engagement / community-management work, analyzing whether a sub's culture is post-driven or discussion-driven.

---

Credentials

The 5 bearer-required endpoints (Access Eligibility, Settings, Post Requirements, Top Posters, Top Commenters) need a Reddit Token V2 cookie + the proxy that minted it. The first 11 endpoints ignore credentials entirely — leave the section blank for those.

Credential lifetime

Credential	Lifetime	When to refresh
Token V2 (token_v2 cookie)	~24 hours	Daily — or save it once in the Reddit Vault and let the vault auto-refresh.

How to extract Token V2 from your browser: open Reddit in Chrome / Brave / Edge / Firefox, then DevTools → Application → Cookies → https://www.reddit.com. Filter by token_v2 and copy the Value column.

You have two options:

Option A — Use a saved account (recommended)

1. Run the Reddit Vault actor once to store a Reddit account under a name you choose (e.g. main, mod-account, burner1). The vault encrypts the Token V2 + matching proxy and stores them keyed by name.
2. In this actor, set Credential source = Use saved account (vault) and put the same name in Saved account name.
3. Done — Token V2 + proxy load automatically. Refresh the vault entry whenever the Token V2 expires (~24 h lifetime).

Option B — Paste Token V2 + proxy directly

For one-off runs without setting up the vault:

1. Set Credential source = Paste Token V2 + proxy.
2. Paste your Reddit token_v2 cookie value (eyJ...) into Token V2.
3. Paste the matching proxy in ip:port:user:pass format into Proxy.

Critical: Reddit IP-binds Token V2 cookies. The proxy MUST be the exact same IP that originally minted the Token V2 — otherwise Reddit returns 401 on every bearer call. Both fields are stored encrypted by Apify.

---

How to run

1. Pick an endpoint in the "What to fetch" dropdown at the top.
2. Open the matching section below it and fill the subreddit (and any extra fields, like Wiki page name or leaderboard Max users).
3. If your endpoint is bearer-required (12–16), fill the Reddit credentials section at the bottom.
4. Click Start.

Each endpoint section is independent — fields outside your chosen section are ignored, so you can leave them as-is between runs. Default subreddit is AskReddit and the default endpoint is Rules, so the actor runs out of the box.

---

Output

Results are pushed to the actor's default dataset. View them as a table or download as JSON / CSV / Excel / XML.

• ID / Access Info / Type / Channels / Style & Widgets / Status / Wiki / Access Eligibility / Settings / Post Requirements push one record per run.
• Rules / Flairs / Emojis push one record per item (one row per rule, flair, emoji).
• Highlights pushes one record per highlighted post.
• Top Posters / Top Commenters push one record containing the full leaderboard payload (tiers, users, count, has_more).

The most useful columns are placed first (endpoint, subreddit, subreddit_id, id, name, etc.) so the dataset Table view is readable without horizontal scrolling.

---

Common edge cases

• Subreddit doesn't exist / banned — Reddit returns no data; the actor pushes an error record. The Status endpoint surfaces the isBanned / isDeleted flags explicitly.
• Private subreddits — anonymous lookups can't see content of private subs. Access Info will tell you isContributorRequired = true; most other public endpoints will be empty. Bearer endpoints work if your account is an approved contributor.
• Quarantined subreddits — usually accessible read-only; Access Info / Status surface the isQuarantined flag, and Access Eligibility (bearer) tells you if your account has acknowledged the quarantine.
• Empty wiki pages — many subreddits have no wiki; the call returns empty content. This is normal.
• No flairs / emojis / highlights — some subreddits configure none of these. An empty list is the expected response, not a failure.
• Bearer expired — Reddit Token V2 cookies live ~24 h. If you get an error_kind: bearer_expired response, refresh the Token V2 in your vault entry (or paste a fresh one in manual mode) and re-run.
• Settings on a sub you don't moderate — call still succeeds but returns only the public-visible subset (name, description, language, country, etc.); mod-only fields are absent.
• Subreddit name with mixed case — Reddit is case-insensitive on subreddit names, but for cleanliness the actor uses whatever you paste. Both AskReddit and askreddit work.

---

Why this actor is fast

• Speed — 1–3 seconds per call, end-to-end (single-page leaderboards 2–4 s; full 1000-user leaderboards 10–20 s due to server-side pagination at 25 / page). Pure GraphQL to Reddit. No browser to boot, no Playwright / Selenium / Puppeteer overhead. Competing browser-based scrapers typically take 15–60 seconds per call.
• Reliability — zero browser flakiness. No headless-Chromium crashes. No JS-render timeouts. No captcha pages. No surprise mid-run failures from a browser quirk.
• Footprint — under 100 MB RAM per run. Most browser-based scrapers need 1–4 GB. We're a thin async dispatcher — Reddit auth, proxy rotation, retry, and GraphQL handling all happen off-actor on our backend.

---

Pricing

Pay-per-result. You're only charged for records actually pushed to the dataset — failed runs cost nothing. See the actor's pricing tab for the current per-result rate.

---

Need a different shape of data?

• For subreddit posts / feeds (the actual posts, not the metadata), see Reddit Feeds V2 → Subreddit Feed.
• For search (finding posts or subreddits by keyword), see Reddit Search V2.
• For single-post + comments, see Reddit Scraper V2.
• For user lookups, see Reddit Users V2.
• For bulk subreddit lookups (up to 1500 subreddit IDs in one call), see Reddit Bulk Scrape V2 (subreddit_info_by_ids mode).
• For storing a Reddit account once and reusing it across actors, see Reddit Vault.
• For moderation actions on a subreddit you own (create, join / leave, post requirements, list your subscriptions), see the V1 moderation actors.