Posting V1
Create Post V1
Create a text/self post. Requires bearer token.
POST /api/v1/publishing/create
Create a text/self post. Requires bearer token.
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | Target subreddit (name, r/name, or URL). |
title | string | Yes | Post title (max 300 chars). |
is_nsfw | string | No | Mark as NSFW (true/false, default: false). |
body | string | No | Post body text — plain text or Reddit markdown both work. Optional for title-only posts. |
flair_id | string | No | Flair template ID (from flair options endpoint). |
proxy | string | No | Proxy. Optional if stored in Token Vault. |
richtext_json | string | No | Rich text JSON (alternative to body). Reddit's internal rich text format. |
is_spoiler | string | No | Mark as spoiler (true/false, default: false). |
bearer | string | No | Bearer token. Optional if stored in Token Vault. |
sendreplies | string | No | Send reply notifications (true/false, default: true). |
flair_text | string | No | Flair display text. |
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/v1/publishing/create" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
-H "Content-Type: application/json" \
--data '{"subreddit": "test", "title": "<title>", "is_nsfw": "<is_nsfw>", "body": "<body>", "flair_id": "<flair_id>", "proxy": "<proxy>", "richtext_json": "<richtext_json>", "is_spoiler": "<is_spoiler>", "bearer": "<bearer>", "sendreplies": "<sendreplies>", "flair_text": "<flair_text>"}'JavaScript
const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v1/publishing/create", {
method: "POST",
headers: {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
},
body: JSON.stringify({
"subreddit": "test",
"title": "<title>",
"is_nsfw": "<is_nsfw>",
"body": "<body>",
"flair_id": "<flair_id>",
"proxy": "<proxy>",
"richtext_json": "<richtext_json>",
"is_spoiler": "<is_spoiler>",
"bearer": "<bearer>",
"sendreplies": "<sendreplies>",
"flair_text": "<flair_text>"
})
});
const data = await res.json();
console.log(data);Python
import requests
url = "https://red-crawler1.p.rapidapi.com/api/v1/publishing/create"
headers = {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
"Content-Type": "application/json"
}
payload = {
"subreddit": "test",
"title": "<title>",
"is_nsfw": "<is_nsfw>",
"body": "<body>",
"flair_id": "<flair_id>",
"proxy": "<proxy>",
"richtext_json": "<richtext_json>",
"is_spoiler": "<is_spoiler>",
"bearer": "<bearer>",
"sendreplies": "<sendreplies>",
"flair_text": "<flair_text>"
}
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": {
"json": {
"errors": [],
"data": {
"url": "https://www.reddit.com/r/RedCrawlerAPI/comments/1sz4fxv/post_test/",
"drafts_count": 0,
"id": "1sz4fxv",
"name": "t3_1sz4fxv"
}
}
},
"error": null,
"timestamp": "2026-04-29T16:50:38.114093+00:00"
}