Create Custom Feed V1

Create a new custom feed (multireddit). The 'multi_name' becomes the permanent URL slug and cannot be changed later. Requires bearer token.

POST /api/v1/feeds/create

Create a new custom feed (multireddit). The 'multi_name' becomes the permanent URL slug and cannot be changed later. Requires bearer token.

Body parameters

Name	Type	Required	Description
`username`	string	Yes	Your Reddit username.
`multi_name`	string	Yes	Permanent URL slug for the feed (cannot be changed later). No spaces, alphanumeric + underscores only.
`bearer`	string	No	Bearer token. Optional if stored in Token Vault.
`subreddits`	string	No	Comma-separated list of subreddits to include.
`proxy`	string	No	Proxy. Optional if stored in Token Vault.
`display_name`	string	No	Display name (can be changed later). Defaults to multi_name if omitted.
`description`	string	No	Description of the custom feed.
`visibility`	string	No	Visibility: private, public, or hidden (default: private).

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/feeds/create" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  --data '{"username": "Motor_Tip8865", "multi_name": "my_test_feed", "bearer": "<bearer>", "subreddits": "test,announcements", "proxy": "<proxy>", "display_name": "My Test Feed", "description": "<description>", "visibility": "private"}'

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v1/feeds/create", {
  method: "POST",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    },
    body: JSON.stringify({
  "username": "Motor_Tip8865",
  "multi_name": "my_test_feed",
  "bearer": "<bearer>",
  "subreddits": "test,announcements",
  "proxy": "<proxy>",
  "display_name": "My Test Feed",
  "description": "<description>",
  "visibility": "private"
})
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v1/feeds/create"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
    "Content-Type": "application/json"
}
payload = {
  "username": "Motor_Tip8865",
  "multi_name": "my_test_feed",
  "bearer": "<bearer>",
  "subreddits": "test,announcements",
  "proxy": "<proxy>",
  "display_name": "My Test Feed",
  "description": "<description>",
  "visibility": "private"
}
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": {
    "kind": "LabeledMulti",
    "data": {
      "can_edit": true,
      "display_name": "My Test Feed1",
      "name": "my_test_feed1",
      "description_html": "",
      "num_subscribers": 0,
      "copied_from": null,
      "icon_url": "https://www.redditstatic.com/custom_feeds/custom_feed_default_9.png",
      "subreddits": [
        {
          "name": "pics"
        },
        {
          "name": "AskReddit"
        }
      ],
      "created_utc": 1777481074,
      "visibility": "private",
      "created": 1777481074,
      "over_18": false,
      "path": "/user/motor_tip8865/m/my_test_feed1",
      "owner": "Motor_Tip8865",
      "key_color": null,
      "is_subscriber": false,
      "owner_id": "t2_29onm7dc32",
      "description_md": "",
      "is_favorited": false
    }
  },
  "error": null,
  "timestamp": "2026-04-29T16:44:35.029006+00:00"
}