How to get Reddit subreddit posts
GET request to /v1/reddit/subreddit-posts with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. List posts from a subreddit with sort, timeframe, and cursor pagination — title, score, upvote ratio, flair, and more.How to get Reddit subreddit posts (step by step)
- 1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
- 2
Call the Reddit Subreddit Posts API
Send an authenticated GET request to /v1/reddit/subreddit-posts with your input. No OAuth, no scraping setup.
- 3
Read the JSON response
Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.
Code example
curl "https://api.captapi.com/v1/reddit/subreddit-posts?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Ftechnology%2F" \
-H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."What the response looks like
{
"success": true,
"data": {
"subreddit": "technology",
"sort": "new",
"timeframe": null,
"totalReturned": 2,
"nextCursor": "t3_1x9mzzt",
"hasMore": true,
"posts": [
{
"platform": "reddit",
"id": "1x9q2lf",
"name": "t3_1x9q2lf",
"url": "https://www.reddit.com/r/technology/comments/1x9q2lf/greece_launches_daedalus_supercomputer_to_boost/",
"title": "Greece launches Daedalus supercomputer to boost AI capabilities and reduce reliance on foreign infrastructure",
"text": null,
"subreddit": "technology",
"author": "New-Ranger-8960",
"authorFullname": "t2_1kg9u759hz",
"score": 5,
"upvoteRatio": 0.6666666666666666,
"scoreHidden": null,
"comments": 1,
"subscriberCount": null,
"isVideo": false,
"publishedAt": "2026-10-19T07:09:28.000Z",
"flair": "Artificial Intelligence",
"nsfw": false,
"thumbnail": null,
"crosspostOf": null
},
{
"platform": "reddit",
"id": "1x9mzzt",
"name": "t3_1x9mzzt",
"url": "https://www.reddit.com/r/technology/comments/1x9mzzt/virtuix_partners_with_meta_to_sell_omni_one/",
"title": "Virtuix Partners With Meta To Sell Omni One Treadmills Bundled With Quest Headsets",
"text": null,
"subreddit": "technology",
"author": "Stukwan",
"authorFullname": "t2_4m79xcva",
"score": 10,
"upvoteRatio": 0.8571428571428571,
"scoreHidden": null,
"comments": 3,
"subscriberCount": null,
"isVideo": false,
"publishedAt": "2026-10-19T04:06:31.000Z",
"flair": "Hardware",
"nsfw": false,
"thumbnail": null,
"crosspostOf": null
}
]
}
}Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Subreddit URL, r/name, or bare name, e.g. r/technology. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble. |
| limit | integer | No | Max items to return (default 25, max 200). Flat 2 credits per call. |
| sort | string | No | Feed sort: best, hot, new (default), top, or rising. |
| timeframe | string | No | For sort=top: hour, day (default), week, month, year, or all. |
| cursor | string | No | Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. |
| cache | boolean | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. |
Frequently asked questions
What does the Reddit Subreddit Posts API do?
The Reddit Subreddit Posts API lets you list items in bulk with metadata from a public Reddit post using one GET request to /v1/reddit/subreddit-posts. It returns clean JSON — no OAuth or infrastructure setup required.
How many credits does the Reddit Subreddit Posts API cost?
Each successful call costs 2 credits. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.
Do I need a Reddit API key or OAuth?
No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle access, rate limits, retries, and authentication for you.
Is the Reddit Subreddit Posts API suitable for production use?
Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.
Ready to get Reddit subreddit posts?
Start free with 100 credits — no credit card required.
Get your free API key