Create GIF Post V1

Create a GIF post. Pass media_url (GIF URL) or base64_data. Requires bearer token.

POST /api/v1/publishing/gif

Create a GIF post. Pass media_url (GIF URL) or base64_data. 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_spoiler`	string	No	Mark as spoiler (true/false, default: false).
`is_nsfw`	string	No	Mark as NSFW (true/false, default: false).
`media_url`	string	No	GIF URL to upload. Either this or base64_data is required.
`base64_data`	string	No	Base64-encoded GIF data. Either this or media_url is required.
`text`	string	No	Optional post body text — plain text or Reddit markdown both work.
`proxy`	string	No	Proxy. Optional if stored in Token Vault.
`sendreplies`	string	No	Send reply notifications (true/false, default: true).
`bearer`	string	No	Bearer token. Optional if stored in Token Vault.

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/gif" \
  -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_spoiler": "<is_spoiler>", "is_nsfw": "<is_nsfw>", "media_url": "<media_url>", "base64_data": "<base64_data>", "text": "<text>", "proxy": "<proxy>", "sendreplies": "<sendreplies>", "bearer": "<bearer>"}'

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v1/publishing/gif", {
  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_spoiler": "<is_spoiler>",
  "is_nsfw": "<is_nsfw>",
  "media_url": "<media_url>",
  "base64_data": "<base64_data>",
  "text": "<text>",
  "proxy": "<proxy>",
  "sendreplies": "<sendreplies>",
  "bearer": "<bearer>"
})
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v1/publishing/gif"
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_spoiler": "<is_spoiler>",
  "is_nsfw": "<is_nsfw>",
  "media_url": "<media_url>",
  "base64_data": "<base64_data>",
  "text": "<text>",
  "proxy": "<proxy>",
  "sendreplies": "<sendreplies>",
  "bearer": "<bearer>"
}
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": {
        "user_submitted_page": "https://www.reddit.com/user/Motor_Tip8865/submitted/",
        "websocket_url": "wss://k8s-lb.wss.redditmedia.com:443/nqr8yxu6n5yg1?m=AQAAtTHyadaVLweVkWoMW1wv0_s4zlgTco8AXZ6uLhHLBSNnFTu-"
      }
    }
  },
  "error": null,
  "meta": {
    "websocket_url": "wss://k8s-lb.wss.redditmedia.com/nqr8yxu6n5yg1?m=AQAAtTHyadaVLweVkWoMW1wv0_s4zlgTco8AXZ6uLhHLBSNnFTu-"
  },
  "timestamp": "2026-04-29T16:18:38.079226+00:00"
}