Posting V1
Create Poll V1
Create a poll post with 2-6 options. Requires bearer token.
POST /api/v1/publishing/poll
Create a poll post with 2-6 options. 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). |
options | string | Yes | JSON array of poll options (2-6). E.g. ["Option A", "Option B", "Option C"] |
flair_id | string | No | Flair template ID. |
duration | string | No | Poll duration in days (1-7, default: 3). |
text | string | No | Optional post body text — plain text or Reddit markdown both work. |
flair_text | string | No | Flair display text. |
proxy | string | No | Proxy. Optional if stored in Token Vault. |
bearer | string | No | Bearer token. Optional if stored in Token Vault. |
is_spoiler | string | No | Mark as spoiler (true/false, default: false). |
sendreplies | string | No | Send reply notifications (true/false, default: true). |
is_nsfw | string | No | Mark as NSFW (true/false, default: false). |
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/poll" \
-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>", "options": "<options>", "flair_id": "<flair_id>", "duration": "<duration>", "text": "<text>", "flair_text": "<flair_text>", "proxy": "<proxy>", "bearer": "<bearer>", "is_spoiler": "<is_spoiler>", "sendreplies": "<sendreplies>", "is_nsfw": "<is_nsfw>"}'JavaScript
const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v1/publishing/poll", {
method: "POST",
headers: {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
},
body: JSON.stringify({
"subreddit": "test",
"title": "<title>",
"options": "<options>",
"flair_id": "<flair_id>",
"duration": "<duration>",
"text": "<text>",
"flair_text": "<flair_text>",
"proxy": "<proxy>",
"bearer": "<bearer>",
"is_spoiler": "<is_spoiler>",
"sendreplies": "<sendreplies>",
"is_nsfw": "<is_nsfw>"
})
});
const data = await res.json();
console.log(data);Python
import requests
url = "https://red-crawler1.p.rapidapi.com/api/v1/publishing/poll"
headers = {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
"Content-Type": "application/json"
}
payload = {
"subreddit": "test",
"title": "<title>",
"options": "<options>",
"flair_id": "<flair_id>",
"duration": "<duration>",
"text": "<text>",
"flair_text": "<flair_text>",
"proxy": "<proxy>",
"bearer": "<bearer>",
"is_spoiler": "<is_spoiler>",
"sendreplies": "<sendreplies>",
"is_nsfw": "<is_nsfw>"
}
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/1sz4f4n/poll_test/",
"id": "t3_1sz4f4n"
}
}
},
"error": null,
"timestamp": "2026-04-29T16:49:52.868614+00:00"
}