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 Reddit subreddit posts with full metadata per item and cursor pagination (nextCursor + hasMore).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": "space",
"totalReturned": 5,
"nextCursor": "t3_1uz5c61",
"hasMore": true,
"posts": [
{
"platform": "reddit",
"id": "1uzov27",
"url": "https://www.reddit.com/r/space/comments/1uzov27/indias_first_privately_developed_orbital_rocket/",
"title": "India's first privately developed orbital rocket, Vikram-1, reaches orbit on its debut flight",
"text": null,
"subreddit": "space",
"author": "PlusCardiologist1799",
"upvotes": 1151,
"comments": 82,
"publishedAt": "2026-07-18T07:04:51+00:00",
"flair": null,
"nsfw": false,
"thumbnail": "https://external-preview.redd.it/ZsMGBF3jLW0ruZn7BHgqQMATfU14coAWySn-Hw3MvuE.jpeg?width=140&height=78&auto=webp&s=da0ca3471cff272906a18e07294f367aff1be5f9"
},
{
"platform": "reddit",
"id": "1uzogx7",
"url": "https://www.reddit.com/r/space/comments/1uzogx7/vikram1_indias_first_private_space_rocket_by/",
"title": "Vikram-1: India's first private space rocket by Skyroot to carry diamond flower",
"text": null,
"subreddit": "space",
"author": "Yeahanu",
"upvotes": 142,
"comments": 10,
"publishedAt": "2026-07-18T06:43:02+00:00",
"flair": null,
"nsfw": false,
"thumbnail": "https://external-preview.redd.it/dqvtu4TvrJHqfPxEkexGWypEtpy_Nlk1_x2g1if3PWU.jpeg?width=140&height=78&auto=webp&s=9db79b3bbf5b02f51ef64917baf97eb90cf946b7"
},
{
"platform": "reddit",
"id": "1uzhhr4",
"url": "https://www.reddit.com/r/space/comments/1uzhhr4/the_rise_and_fall_of_nasa/",
"title": "The rise and fall of NASA",
"text": null,
"subreddit": "space",
"author": "jeffsmith202",
"upvotes": 0,
"comments": 9,
"publishedAt": "2026-07-18T00:50:18+00:00",
"flair": null,
"nsfw": false,
"thumbnail": "https://external-preview.redd.it/vT5tVhZUWFii4x_na7hOshAJfkkhl7qVJElEdAoGfjE.jpeg?width=140&height=105&auto=webp&s=7e4fb403a796cea5c94a97cd8de5eb7c5a4a19ee"
},
{
"platform": "reddit",
"id": "1uzaoq3",
"url": "https://www.reddit.com/r/space/comments/1uzaoq3/googlebacked_satellites_for_wildfire_detection/",
"title": "Google-backed satellites for wildfire detection launch as smoke chokes US, Canada | The FireSat program can spot wildfires that other satellites miss.",
"text": null,
"subreddit": "space",
"author": "FreeHugs23",
"upvotes": 288,
"comments": 24,
"publishedAt": "2026-07-17T20:08:03+00:00",
"flair": null,
"nsfw": false,
"thumbnail": "https://external-preview.redd.it/PD6_uR0U5hBIs4hbUOmD1O33Wx0FtSyYsexiswL8chE.png?width=140&height=78&auto=webp&s=56558e593f00d42b5cb7988c5bbe13c47e00682f"
},
{
"platform": "reddit",
"id": "1uz5c61",
"url": "https://www.reddit.com/r/space/comments/1uz5c61/regarding_august_12_solar_eclipse_a_quick_safety/",
"title": "Regarding August 12 Solar Eclipse: A Quick Safety Check for Your Eclipse Glasses",
"text": "As the August 12 total solar eclipse approaches, I wanted to share a story. In 2024 I bought a set of solar eclipse glasses and found that the Sun looked way too bright for comfort. By chance I tried them on inside, and I could see light bulbs, ceiling fans, etc. I was pretty sure that wasn't supposed to happen.\n\nThat sent me down a rabbit hole researching how to tell whether the eclipse glasses were safe or not. I found three simple checks that anyone can do:\n\n**1) Check the markings:** Legit eclipse glasses should have printed information indicating compliance with the ISO 12312-2 standard. This is not a guarantee, but it shows they did their homework.\n\n**2) Try them indoors first:** You should not be able to see ordinary objects or details in the room through properly rated eclipse glasses. It's normal to see the filament from a bright incandescent bulb or a really bright LED light.\n\n**3) Check the manufacturer:** The American Astronomical Society keeps a list of vetted solar eclipse glasses makers.\n\nIf you'd like to see these checks demonstrated, I put together a short video (please forgive my jumpiness, too much caffeine):\n\n[https://youtu.be/Q8aYrD32aAM](https://youtu.be/Q8aYrD32aAM)\n\nI hope all of you lucky enough to see the upcoming total solar eclipse has a wonderful time. The 2024 experience was amazing.",
"subreddit": "space",
"author": "SillyEngineer",
"upvotes": 116,
"comments": 22,
"publishedAt": "2026-07-17T16:54:59+00:00",
"flair": "Discussion",
"nsfw": false,
"thumbnail": 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). Billed per result. |
| 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. Default false — always fetch fresh data. |
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 shared cache (0 credits on hit); default is always fresh. 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 proxies, 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 shared cache (0 credits on hit); default is always fresh. 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