Post Flair (Mod) V2

Set or clear a post's flair as a moderator override. Provide `text` for custom flair text, `flair_template_id` to use a template, or both. Omit all flair field

POST /api/v2/mod/post-flair

Set or clear a post's flair as a moderator override.

Provide text for custom flair text, flair_template_id to use a template, or both. Omit all flair fields to clear the flair.

Accepts post URLs, t3_ fullnames, or bare post IDs.

Body parameters

Name	Type	Required	Description
`post`	string	Yes	Post: URL, t3_ fullname, or bare post ID.
`bearer`	string	No	Reddit bearer token. Auto-resolves from Token Vault.
`flair_template_id`	string	No	Flair template UUID from the subreddit's flair list.
`text`	string	No	Custom flair text. Omit to use template only or clear flair.
`proxy`	string	No	Proxy `ip:port:user:pass`. Auto-resolves from Token Vault.

Authentication

Header	Value
`X-RapidAPI-Key`	Your RapidAPI key
`X-RapidAPI-Host`	`red-crawler1.p.rapidapi.com`

Example request

cURL

curl -X POST "https://red-crawler1.p.rapidapi.com/api/v2/mod/post-flair" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  --data '{"post": "t3_1sys4r2", "bearer": "<bearer>", "flair_template_id": "<flair_template_id>", "text": "<text>", "proxy": "<proxy>"}'

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/mod/post-flair", {
  method: "POST",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    },
    body: JSON.stringify({
  "post": "t3_1sys4r2",
  "bearer": "<bearer>",
  "flair_template_id": "<flair_template_id>",
  "text": "<text>",
  "proxy": "<proxy>"
})
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/mod/post-flair"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
    "Content-Type": "application/json"
}
payload = {
  "post": "t3_1sys4r2",
  "bearer": "<bearer>",
  "flair_template_id": "<flair_template_id>",
  "text": "<text>",
  "proxy": "<proxy>"
}
resp = requests.post(url, headers=headers, json=payload)
print(resp.json())

Example response

HTTP 200 — captured from a live call to the gateway.

{
  "success": true,
  "data": {
    "ok": true,
    "post_id": "t3_1sz24fg"
  },
  "error": null,
  "meta": {
    "vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
    "vault_remaining": "15h 58m"
  },
  "timestamp": "2026-04-29T15:49:09.698509+00:00"
}