Schedule Poll Post V2

Schedule a poll post. Requires bearer token stored in Token Vault. The background scheduler publishes at the specified time using your stored bearer and proxy.

POST /api/v2/schedule/poll

Schedule a poll post. Requires bearer token stored in Token Vault. The background scheduler publishes at the specified time using your stored bearer and proxy. Max 20 pending per user.

Body parameters

Name	Type	Required	Description
`publish_at`	string	Yes	When to publish (ISO-8601 UTC, e.g. 2026-04-11T15:00:00Z)
`title`	string	Yes	Post title
`subreddit`	string	Yes	Target subreddit (name, r/name, or URL)
`poll_options`	string	Yes	Comma-separated poll options or JSON array (min 2)
`flair_id`	string	No	Flair template ID
`brand_affiliate`	string	No	Mark as brand affiliate / commercial (true/false)
`bearer`	string	No	Bearer token. Optional if stored in Token Vault.
`flair_text`	string	No	Flair text
`poll_duration`	string	No	Poll duration in days (1-7, default 3)
`proxy`	string	No	Proxy. Optional if stored in Token Vault.
`spoiler`	string	No	Mark as spoiler (true/false)
`nsfw`	string	No	Mark as NSFW (true/false)
`body`	string	No	Post body — plain text or Reddit markdown both work
`delete_after`	string	No	Auto-delete post after N seconds (optional)

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/schedule/poll" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  --data '{"publish_at": "<publish_at>", "title": "<title>", "subreddit": "test", "poll_options": "<poll_options>", "flair_id": "<flair_id>", "brand_affiliate": "<brand_affiliate>", "bearer": "<bearer>", "flair_text": "<flair_text>", "poll_duration": "<poll_duration>", "proxy": "<proxy>", "spoiler": "<spoiler>", "nsfw": "<nsfw>", "body": "<body>", "delete_after": "<delete_after>"}'

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/schedule/poll", {
  method: "POST",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    },
    body: JSON.stringify({
  "publish_at": "<publish_at>",
  "title": "<title>",
  "subreddit": "test",
  "poll_options": "<poll_options>",
  "flair_id": "<flair_id>",
  "brand_affiliate": "<brand_affiliate>",
  "bearer": "<bearer>",
  "flair_text": "<flair_text>",
  "poll_duration": "<poll_duration>",
  "proxy": "<proxy>",
  "spoiler": "<spoiler>",
  "nsfw": "<nsfw>",
  "body": "<body>",
  "delete_after": "<delete_after>"
})
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/schedule/poll"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
    "Content-Type": "application/json"
}
payload = {
  "publish_at": "<publish_at>",
  "title": "<title>",
  "subreddit": "test",
  "poll_options": "<poll_options>",
  "flair_id": "<flair_id>",
  "brand_affiliate": "<brand_affiliate>",
  "bearer": "<bearer>",
  "flair_text": "<flair_text>",
  "poll_duration": "<poll_duration>",
  "proxy": "<proxy>",
  "spoiler": "<spoiler>",
  "nsfw": "<nsfw>",
  "body": "<body>",
  "delete_after": "<delete_after>"
}
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": {
    "updated": true,
    "id": 117,
    "subreddit": "RedCrawlerAPI",
    "parent_id": "",
    "title": "Schedule Poll Post V2",
    "type": "poll",
    "publish_at": "2026-05-12T15:00:00+00:00",
    "delete_after": 2000,
    "delete_at": "2026-05-12T15:33:20+00:00",
    "status": "pending"
  },
  "error": null,
  "timestamp": "2026-04-29T17:32:16.628594+00:00"
}