# Reddit Flairs V2 — Post Flairs & User Flairs (2 endpoints) (`red_crawler/reddit-flairs-v2`) Actor
Fetch a subreddit's available post flairs or user flairs at scale. 2 self-contained endpoints, no Reddit account or proxy required.
- **URL**: https://apify.com/red\_crawler/reddit-flairs-v2.md
- **Developed by:** [Red Crawler](https://apify.com/red_crawler) (community)
- **Categories:** Lead generation, SEO tools, Social media
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars
## Pricing
from $1.99 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## 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**
```json
{
"endpoint": "post_flairs",
"post_flairs_subreddit": "wordpress"
}
````
**Output** *(one dataset record per flair)*
```json
{
"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**
```json
{
"endpoint": "user_flairs",
"user_flairs_subreddit": "wordpress"
}
```
**Output** *(one dataset record per flair)*
```json
{
"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](https://apify.com/red_crawler/reddit-subreddits)** — info, browse, join / leave, create — also includes a `show-my-flair` toggle
- **[Reddit Posting V2](https://apify.com/red_crawler/reddit-posting-v2)** — create text / link / image / gallery / video / GIF / crosspost / poll posts (with flair)
- **[Reddit Post Manager V1](https://apify.com/red_crawler/reddit-manage-posts-v1)** — apply / clear flair on existing posts (uses `flair_id` from this actor)
- **[Reddit Users V1](https://apify.com/red_crawler/reddit-users)** — profile, lookup, follow, block, friend, show / hide your flair on a subreddit
- **[Reddit Vault](https://apify.com/red_crawler/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.*
# Actor input Schema
## `endpoint` (type: `string`):
Choose which flair list to fetch.
## `post_flairs_subreddit` (type: `string`):
Subreddit name (without r/).
## `user_flairs_subreddit` (type: `string`):
Subreddit name (without r/).
## Actor input object example
```json
{
"endpoint": "post_flairs",
"post_flairs_subreddit": "SpaceX_Starship_News",
"user_flairs_subreddit": "SpaceX_Starship_News"
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"endpoint": "post_flairs",
"post_flairs_subreddit": "SpaceX_Starship_News",
"user_flairs_subreddit": "SpaceX_Starship_News"
};
// Run the Actor and wait for it to finish
const run = await client.actor("red_crawler/reddit-flairs-v2").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"endpoint": "post_flairs",
"post_flairs_subreddit": "SpaceX_Starship_News",
"user_flairs_subreddit": "SpaceX_Starship_News",
}
# Run the Actor and wait for it to finish
run = client.actor("red_crawler/reddit-flairs-v2").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"endpoint": "post_flairs",
"post_flairs_subreddit": "SpaceX_Starship_News",
"user_flairs_subreddit": "SpaceX_Starship_News"
}' |
apify call red_crawler/reddit-flairs-v2 --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=red_crawler/reddit-flairs-v2",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Reddit Flairs V2 — Post Flairs & User Flairs (2 endpoints)",
"description": "Fetch a subreddit's available post flairs or user flairs at scale. 2 self-contained endpoints, no Reddit account or proxy required.",
"version": "1.0",
"x-build-id": "1bywIu17KAezRlsLh"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/red_crawler~reddit-flairs-v2/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-red_crawler-reddit-flairs-v2",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/red_crawler~reddit-flairs-v2/runs": {
"post": {
"operationId": "runs-sync-red_crawler-reddit-flairs-v2",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/red_crawler~reddit-flairs-v2/run-sync": {
"post": {
"operationId": "run-sync-red_crawler-reddit-flairs-v2",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"endpoint"
],
"properties": {
"endpoint": {
"title": "What to fetch",
"enum": [
"post_flairs",
"user_flairs"
],
"type": "string",
"description": "Choose which flair list to fetch.",
"default": "post_flairs"
},
"post_flairs_subreddit": {
"title": "Subreddit",
"type": "string",
"description": "Subreddit name (without r/)."
},
"user_flairs_subreddit": {
"title": "Subreddit",
"type": "string",
"description": "Subreddit name (without r/)."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```