Create Video Post V2

Create a video post on a subreddit. Provide `video_url` — a public MP4 URL. Optional `poster_url` overrides the default thumbnail. Requires bearer token.

POST /api/v2/posting/video

Create a video post on a subreddit. Provide video_url — a public MP4 URL. Optional poster_url overrides the default thumbnail. Requires bearer token.

Body parameters

Name	Type	Required	Description
`subreddit`	string	Yes	Target subreddit (name, r/name, or URL).
`video_url`	string	Yes	Public video URL (mp4).
`title`	string	Yes	Post title (max 300 chars).
`brand_affiliate`	string	No	Brand affiliate disclosure (true/false).
`body`	string	No	Optional markdown body.
`bearer`	string	No	Reddit bearer token (token_v2). Optional if stored in Token Vault for your key.
`proxy`	string	No	Proxy ip:port:user:pass. Optional if stored in Token Vault.
`spoiler`	string	No	Mark spoiler (true/false).
`nsfw`	string	No	Mark NSFW (true/false).
`flair_text`	string	No	Flair display text.
`flair_id`	string	No	Flair template ID.

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

JavaScript

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

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/posting/video"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
    "Content-Type": "application/json"
}
payload = {
  "subreddit": "test",
  "video_url": "<video_url>",
  "title": "<title>",
  "brand_affiliate": "<brand_affiliate>",
  "body": "<body>",
  "bearer": "<bearer>",
  "proxy": "<proxy>",
  "spoiler": "<spoiler>",
  "nsfw": "<nsfw>",
  "flair_text": "<flair_text>",
  "flair_id": "<flair_id>"
}
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": {
    "success": true,
    "post": {
      "post": {
        "id": "t3_1sz4qu8",
        "title": "Video Post",
        "languageCode": null,
        "isNsfw": false,
        "domain": "v.redd.it",
        "createdAt": "2026-04-29T17:01:18.577000+0000",
        "url": "https://v.redd.it/w6knepjsu5yg1",
        "authorInfo": {
          "id": "t2_29onm7dc32"
        },
        "subreddit": {
          "id": "t5_hmeujo",
          "name": "RedCrawlerAPI"
        },
        "postEventInfo": null
      },
      "websocketUrl": "wss://k8s-lb.wss.redditmedia.com/w6knepjsu5yg1?m=AQAAtjvyafYMQb-lPabOJqS0FVQhChJRlbFNq6-kO2y10zldElSh",
      "ok": true,
      "errors": null,
      "fieldErrors": null
    }
  },
  "error": null,
  "meta": {
    "vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
    "vault_remaining": "14h 46m"
  },
  "timestamp": "2026-04-29T17:01:18.821709+00:00"
}