How to get Reddit post comments
GET request to /v1/reddit/post-comments with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. Flat Reddit comment threads with depth/parentId, ISO timestamps, score, and the parent post in one call.How to get Reddit post comments (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 Post Comments API
Send an authenticated GET request to /v1/reddit/post-comments 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/post-comments?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Ftechnology%2Fcomments%2F1a2b3c4%2Fexample_discussion_thread%2F" \
-H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."What the response looks like
{
"success": true,
"data": {
"totalReturned": 3,
"comments": [
{
"id": "p0gnsr6",
"author": "AutoModerator",
"authorFullname": "t2_6l4z3",
"text": "Users often report submissions from this site for sensationalized articles. Readers have a responsibility to be skeptical, check sources, and comment on any flaws.\n\nYou can help improve this thread by linking to media that verifies or questions this article's claims. Your link could help readers better understand this issue.\n\n*I am a bot, and this action was performed automatically. Please [contact the moderators of this subreddit](/message/compose/?to=/r/worldnews) if you have any questions or concerns.*",
"upvotes": 1,
"score": 1,
"downs": 0,
"publishedAt": "2026-07-29T13:12:05.000Z",
"url": "https://www.reddit.com/r/worldnews/comments/1v9vtop/japans_population_falls_below_120_million_for/p0gnsr6/",
"parentId": "t3_1v9vtop",
"depth": 0,
"isSubmitter": false,
"edited": false,
"stickied": true,
"distinguished": "moderator",
"controversiality": 0,
"subreddit": "worldnews"
},
{
"id": "p0gpy2l",
"author": "Donnicton",
"authorFullname": "t2_8iha3",
"text": "Sorry, best we can do about it is symbolically send you home early one day this month to go make a kid or whatever.",
"upvotes": 10014,
"score": 10014,
"downs": 0,
"publishedAt": "2026-07-29T13:22:22.000Z",
"url": "https://www.reddit.com/r/worldnews/comments/1v9vtop/japans_population_falls_below_120_million_for/p0gpy2l/",
"parentId": "t3_1v9vtop",
"depth": 0,
"isSubmitter": false,
"edited": false,
"stickied": false,
"distinguished": null,
"controversiality": 0,
"subreddit": "worldnews"
}
],
"post": {
"platform": "reddit",
"id": "1v9vtop",
"name": "t3_1v9vtop",
"url": "https://www.reddit.com/r/worldnews/comments/1v9vtop/japans_population_falls_below_120_million_for/",
"title": "Japan's population falls below 120 million for first time in 42 years as birth crisis deepens",
"text": null,
"subreddit": "worldnews",
"author": "rdh2dmd",
"authorFullname": "t2_2i0a3navkp",
"upvotes": 24395,
"score": 24395,
"downs": 0,
"upvoteRatio": 0.95,
"comments": 2932,
"subscriberCount": 47503811,
"totalAwardsReceived": null,
"isVideo": false,
"publishedAt": "2026-07-29T13:12:05+00:00",
"flair": null,
"nsfw": false,
"thumbnail": "https://external-preview.redd.it/z1-dgwVNE_wakjIdcx8RRK7U5pnn5xhdXdXqCAQGY6U.jpeg?width=140&height=78&auto=webp&s=51c84bd9c71d792505f54b10d4023457a63d5495"
}
}
}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 | Reddit post URL. 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 50, max 500). Flat 2 credits per call. |
| cache | boolean | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. |
Frequently asked questions
What does the Reddit Post Comments API do?
The Reddit Post Comments API lets you pull comments with author, text, likes, and replies from a public Reddit post using one GET request to /v1/reddit/post-comments. It returns clean JSON — no OAuth or infrastructure setup required.
How many credits does the Reddit Post Comments 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. Hits include cached + cachedAt. 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 proxies, rate limits, retries, and authentication for you.
Is the Reddit Post Comments 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. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.
Ready to get Reddit post comments?
Start free with 100 credits — no credit card required.
Get your free API key