Ban Subreddit User V2

Ban a user from a subreddit. Optional `duration_days` (1-999) for a temporary ban; omit for permanent. Provide `reason` (short rule code — no colons), `message

POST /api/v2/mod/ban

Ban a user from a subreddit.

Optional duration_days (1-999) for a temporary ban; omit for permanent. Provide reason (short rule code — no colons), message (ban message sent to user), and mod_note (internal note visible to other mods).

NOTE: Reddit splits the reason at the first ':' and appends the rest to mod_note. Keep reason as a simple code like 'spam' or 'rule1'.

Body parameters

Name	Type	Required	Description
`subreddit`	string	Yes	Subreddit: name, r/name, URL, or t5_ ID.
`user`	string	Yes	Reddit user: username, u/name, profile URL, or t2_ ID.
`duration_days`	number	No	Ban duration in days (1-999). Omit for permanent ban.
`reason`	string	No	Short ban reason code (no colons). E.g. 'spam', 'rule1'.
`mod_note`	string	No	Internal mod note (visible to other mods only).
`proxy`	string	No	Proxy `ip:port:user:pass`. Auto-resolves from Token Vault.
`bearer`	string	No	Reddit bearer token. Auto-resolves from Token Vault.
`message`	string	No	Ban message sent to the user.

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/ban" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  --data '{"subreddit": "SpaceX_Starship_News", "user": "Motor_Tip8865", "duration_days": "1", "reason": "spam", "mod_note": "<mod_note>", "proxy": "<proxy>", "bearer": "<bearer>", "message": "<message>"}'

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/mod/ban", {
  method: "POST",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    },
    body: JSON.stringify({
  "subreddit": "SpaceX_Starship_News",
  "user": "Motor_Tip8865",
  "duration_days": "1",
  "reason": "spam",
  "mod_note": "<mod_note>",
  "proxy": "<proxy>",
  "bearer": "<bearer>",
  "message": "<message>"
})
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/mod/ban"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
    "Content-Type": "application/json"
}
payload = {
  "subreddit": "SpaceX_Starship_News",
  "user": "Motor_Tip8865",
  "duration_days": "1",
  "reason": "spam",
  "mod_note": "<mod_note>",
  "proxy": "<proxy>",
  "bearer": "<bearer>",
  "message": "<message>"
}
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
  },
  "error": null,
  "meta": {
    "vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
    "vault_remaining": "16h 4m"
  },
  "timestamp": "2026-04-29T15:42:50.390560+00:00"
}