Fetch Subreddit Posts Feed (hot / new / top / rising)

GET/v1/subreddit/posts

Query Parameters

subredditstringrequired
sortstring
time_filterstring
limitinteger (1 to 100)
cursorstring

Example Request (cURL / Python / JavaScript)

curl "https://api.redditdataapi.io/v1/subreddit/posts?subreddit=" \
  -H "x-api-key: rd_live_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://redditdataapi.io",
  "status": "ok",
  "msg": "success",
  "data": {
    "items": [
      {
        "id": "1xmjld9",
        "post_id": "t3_1xmjld9",
        "subreddit": "saas",
        "subreddit_name_prefixed": "r/saas",
        "title": "How we scaled our B2B SaaS to $42k MRR using automated Reddit brand mention alerts",
        "selftext": "We built an internal keyword monitor across r/saas, r/startups, and r/entrepreneur...",
        "author": "indie_founder_io",
        "score": 384,
        "upvote_ratio": 0.96,
        "num_comments": 78,
        "created_utc": 1762286400,
        "created_at": "2026-11-04T20:00:00.000Z",
        "url": "https://www.reddit.com/r/saas/comments/1xmjld9/how_we_scaled_our_b2b_saas/",
        "permalink": "https://www.reddit.com/r/saas/comments/1xmjld9/how_we_scaled_our_b2b_saas/",
        "domain": "self.saas",
        "flair": "Case Study",
        "over_18": false,
        "is_nsfw": false,
        "is_video": false,
        "is_self": true
      }
    ],
    "count": 1,
    "next_cursor": "t3_1xmjld9",
    "cursor": "t3_1xmjld9",
    "has_more": true,
    "hasMore": true
  },
  "meta": {
    "request_id": "c42d9f10-81e3-4c22-9118-092f1a8b1122",
    "endpoint": "/v1/subreddit/posts",
    "credits_used": 2,
    "credits_remaining": 249998,
    "cache_hit": false,
    "data_age_seconds": 0,
    "latency_ms": 185
  }
}

Response Fields

Normalized subreddit posts list (1 Credit per post returned, min 2 Credits)

Field	Type	Sample / Notes
`code`	integer	0 on success
`status`	string	Response status
`data`	object	Normalized post feed payload
`items`	array of RedditPost	Array of normalized Reddit posts
`id`	string	Example: 1xmjld9
`post_id`	string	Example: t3_1xmjld9
`subreddit`	string	Example: SaaS
`subreddit_name_prefixed`	string	Example: r/SaaS
`title`	string	Example: How we scaled our B2B API from $0 to $42k MRR with developer
`selftext`	string	Example: Here is the exact breakdown of our engineering-led growth lo
`author`	string	Example: saas_builder_99
`score`	integer	Example: 418
`upvote_ratio`	number	Example: 0.96
`num_comments`	integer	Example: 87
`created_utc`	integer	Example: 1762254000
`created_at`	string	Example: 2026-11-04T11:00:00.000Z
`url`	string	Example: https://www.reddit.com/r/SaaS/comments/1xmjld9/how_we_scaled
`permalink`	string	Example: https://www.reddit.com/r/SaaS/comments/1xmjld9/how_we_scaled
`domain`	string	Example: self.SaaS
`flair`	string	Example: Case Study
`over_18`	boolean	Example: false
`is_nsfw`	boolean	Example: false
`is_video`	boolean	Example: false
`is_self`	boolean	Example: true
`count`	integer	Number of items returned in this page
`next_cursor`	string	Pagination cursor for next page
`has_more`	boolean	Whether another page is available
`meta`	ResponseMeta
`request_id`	string	UUID v4 request identifier
`endpoint`	string	Canonical /v1/* endpoint path
`credits_used`	integer	Credits deducted for this call (0 on error or empty)
`credits_remaining`	integer	Remaining credit balance on account
`cache_hit`	boolean	Whether served from L1 Redis cache
`data_age_seconds`	integer	Age of cached payload in seconds
`latency_ms`	integer	End-to-end gateway latency in milliseconds

Status Codes

200: Normalized subreddit posts list (1 Credit per post returned, min 2 Credits)