Subreddit Feed V2

Fetch posts from a specific subreddit. Supports sorting by Hot, New, Top, Rising, Best, and Controversial with time filters.

GET /api/v2/feed/subreddit

Fetch posts from a specific subreddit. Supports sorting by Hot, New, Top, Rising, Best, and Controversial with time filters.

Query parameters

Name	Type	Required	Description
`subreddit`	string	Yes	Subreddit name, r/name, or full URL (e.g. test, r/test, reddit.com/r/test)
`limit`	string	No	Max posts to return, auto-paginates (1-500, default: 100)
`time_filter`	string	No	Time filter for top/controversial: hour, day, week, month, year, all
`sort`	string	No	Sort order: hot, new, top, rising, best, controversial (default: hot)

Authentication

Header	Value
`X-RapidAPI-Key`	Your RapidAPI key
`X-RapidAPI-Host`	`red-crawler1.p.rapidapi.com`

Example request

cURL

curl -X GET "https://red-crawler1.p.rapidapi.com/api/v2/feed/subreddit?subreddit=test&limit=25&time_filter=<time_filter>&sort=hot" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com"

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/feed/subreddit?subreddit=test&limit=25&time_filter=<time_filter>&sort=hot", {
  method: "GET",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/feed/subreddit?subreddit=test&limit=25&time_filter=<time_filter>&sort=hot"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.get(url, headers=headers)
print(resp.json())

Example response

HTTP 200 — captured from a live call to the gateway.

{
  "success": true,
  "data": {
    "success": true,
    "items": [
      {
        "node": {
          "id": "c29ydGNlbGw=",
          "groupId": "sortcell",
          "payload": null,
          "adPayload": null,
          "groupRecommendationContext": null,
          "cells": [
            {
              "isModerator": false,
              "layoutOptions": [
                "CARD",
                "CLASSIC"
              ]
            }
          ],
          "crosspostCells": [
            {}
          ]
        }
      },
      {
        "node": {
          "id": "dDNfMThkYTF6bA==",
          "groupId": "t3_1sys4r2",
          "payload": null,
          "adPayload": null,
          "groupRecommendationContext": null,
          "cells": [
            {
              "id": "TWV0YWRhdGFDZWxsLXQzXzE4ZGExemw=",
              "createdAt": "2023-12-08T00:29:02.012000+0000",
              "authorName": "u/PitchforkAssistant",
              "color": {},
              "detailsString": "u/PitchforkAssistant",
              "detailsLink": "PitchforkAssistant",
              "iconPath": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
              "iconShape": "ROUND_WITH_BORDER",
              "isJoinButtonShown": false,
              "joinSubredditId": null,
              "isOverflowButtonHidden": false,
              "mediaPath": null,
              "mediaDomain": null,
              "isRecommended": false,
              "statusIndicators": [
                "MOD",
                "PINNED"
              ],
              "isBrandAffiliate": false,
              "modUserNoteLabel": null
            },
            {
              "id": "VGl0bGVDZWxsLXQzXzE4ZGExemw=",
              "title": "Some test commands",
              "isVisited": false
            },
            "\u2026 (3 more items)"
          ],
          "crosspostCells": [
            {},
            {},
            "\u2026 (3 more items)"
          ]
        }
      }
    ],
    "count": 2
  },
  "error": null,
  "timestamp": "2026-04-29T09:00:12.848611+00:00"
}