Reddit Flairs V2

Fetch a subreddit's available post flairs or user flairs in one click. Two self-contained endpoints, no Reddit account or proxy required — perfect for harvesting flair-template IDs so you can flair posts / users programmatically with other actors.

---

What you can do

The Subreddit field on each endpoint accepts a bare name (wordpress) — strip the leading r/ if you pasted one.

The output is the raw flair-template list from Reddit, normalized into one row per flair. Every row carries the flair's UUID id — that's the value you paste into the flair_id field of other actors (e.g. Reddit Post Manager V1, Reddit Posting V2) when applying flairs.

Both endpoints (no credentials needed)

1. Post Flairs — flairs assignable to posts in the subreddit

Returns every post flair template the subreddit publishes (the dropdown you see when submitting a post).

Returns: array — one record per flair template with {endpoint, type, subreddit, id, text, richtext, textColor, backgroundColor, isEditable, isModOnly, maxEmojis, allowableContent}.

Use it when: building a flair picker UI for your tooling, scripting bulk re-flair, pre-fetching flair IDs to feed into other actors that apply flairs.

Example

Input

{
  "endpoint": "post_flairs",
  "post_flairs_subreddit": "wordpress"
}

Output (one dataset record per flair)

{
  "endpoint": "post_flairs",
  "type": "post_flairs",
  "subreddit": "wordpress",
  "id": "b62b87a6-54ce-11e4-a34f-12313d163ca7",
  "text": "Help Request",
  "richtext": "[{\"e\":\"text\",\"t\":\"Help Request\"}]",
  "textColor": "LIGHT",
  "backgroundColor": "#EA0027",
  "isEditable": false,
  "isModOnly": false,
  "maxEmojis": 10,
  "allowableContent": "ALL"
}

2. User Flairs — flairs assignable to users in the subreddit

Returns every user flair template the subreddit publishes (the flair members of the community can pick for themselves).

Returns: array — one record per user flair template with the same shape as Post Flairs plus __typename: "FlairTemplate".

Use it when: picking your own user flair via the Reddit Subreddits actor's flair-setter, auditing what flairs a community offers, building community-onboarding tooling.

Example

Input

{
  "endpoint": "user_flairs",
  "user_flairs_subreddit": "wordpress"
}

Output (one dataset record per flair)

{
  "endpoint": "user_flairs",
  "type": "user_flairs",
  "subreddit": "wordpress",
  "id": "60b990e8-055c-11e1-b191-12313b0cf4c9",
  "text": "Developer/Blogger",
  "richtext": "[{\"e\":\"text\",\"t\":\"Developer/Blogger\"}]",
  "textColor": "DARK",
  "backgroundColor": null,
  "isEditable": false,
  "isModOnly": false,
  "maxEmojis": 10,
  "allowableContent": "ALL",
  "__typename": "FlairTemplate"
}

---

Credentials

None required. Both endpoints are fully anonymous — no Reddit account, no proxy. Just paste the subreddit name and run.

---

How to run

1. What to fetch → Post Flairs or User Flairs.
2. Fill the matching section's Subreddit field (bare name, no r/).
3. Hit Start. Each flair template = one row in the dataset.

---

Output

Records are pushed to the run's default dataset — one row per flair template.

Front-loaded column	Meaning
endpoint	post_flairs or user_flairs
type	Same as endpoint (kept for joining datasets across runs)
subreddit	Echoed subreddit name
id	The flair UUID — paste this into other actors' flair_id fields
text	Flair display text
richtext	JSON-encoded richtext (supports inline emojis / segments)
textColor	LIGHT or DARK
backgroundColor	Hex color or null
isEditable	Boolean — whether the flair text can be edited by the user when applying it
isModOnly	Boolean — whether only moderators can apply this flair
allowableContent	ALL, EMOJI, TEXT, etc. — what segments the flair allows
maxEmojis	Max emojis allowed in the flair

Empty results push one summary row ({endpoint, type, subreddit, flairs: []}) so a successful run with no flairs still produces a visible record.

---

Common edge cases

Edge case	Cause	How it surfaces
Subreddit private / banned / quarantined	Reddit returns UnavailableSubreddit	Row with flairs: [] and the raw Reddit response.
Subreddit doesn't exist	Typo in the name	Row with flairs: [] and the raw response.
Subreddit has no flairs configured	Mods haven't set any flair templates	Row with flairs: []. Not an error — just an empty list.
Empty subreddit name	Forgot to fill the Subreddit field	Run FAILED immediately, no row pushed, no charge.

---

Why this actor is fast

• Speed — under 1 second per call. Pure HTTP. No browser to boot, no Playwright / Selenium / Puppeteer overhead. Competing browser-based actors typically take 15–60 seconds per call.
• Reliability — zero browser flakiness. No headless-Chromium crashes. No JS-render timeouts. No captcha pages.
• Footprint — under 100 MB RAM per run. Most browser-based actors need 1–4 GB.
• No proxy to configure. Anonymous — the backend rotates infrastructure behind the scenes.

---

Status & error reference

Run status (Apify-side, shown on the run page)

Status	Apify message	Meaning	What to do
	"Actor succeeded with N results in the dataset"	Run finished, records pushed.	Open the dataset to view the result.
	"The Actor process failed…"	Validation error or missing required input.	Check the run log. You are NOT charged for failed runs.
	"The Actor timed out. You can resurrect it with a longer timeout to continue where you left off."	Run exceeded timeout (very rare — flair lookups are fast).	Re-run; check Reddit is reachable.
	"The Actor process was aborted. You can resurrect it to continue where you left off."	You stopped the run manually.	No charge for unpushed results.

Common in-run conditions (visible in run log and output record)

Condition	Cause	Result
UnavailableSubreddit	Subreddit is private / banned / quarantined / doesn't exist.	Run SUCCEEDED, single row with empty flairs: [] and the raw response.
Validation error: missing subreddit	Required input not provided.	Run FAILED immediately, no charge.

---

Pricing

Pay-per-result. You're only charged for records actually pushed to the dataset — failed runs and validation errors cost nothing.

Event	Trigger	Price (per 1,000)
result	Each row pushed to the dataset (one per flair template)	$0.99

A subreddit with 20 post flairs = 20 rows. A subreddit with no flairs = 1 row (empty summary). A run that errors during validation = 0 rows, 0 charge.

---

Need a different shape of data?

• Reddit Subreddits — info, browse, join / leave, create — also includes a show-my-flair toggle
• Reddit Posting V2 — create text / link / image / gallery / video / GIF / crosspost / poll posts (with flair)
• Reddit Post Manager V1 — apply / clear flair on existing posts (uses flair_id from this actor)
• Reddit Users V1 — profile, lookup, follow, block, friend, show / hide your flair on a subreddit
• Reddit Vault — save Reddit accounts once, call them by name from auth-required actors

---

Support and feedback

Found a bug, want a feature, or hit a Reddit error code we don't translate clearly? Open an issue via the actor's Apify Console feedback link, or reach out at the RedCrawler support channel.

---

Reddit Flairs V2 is part of the RedCrawler family of Reddit actors. RedCrawler is independent — not affiliated with, endorsed by, or sponsored by Reddit, Inc. Use it within Reddit's API terms.