# Reddit Comments API. Post comments and replies, page by page. Post comments and replies, in thread order. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dreddit.comments) ## Reddit Comments API at a glance Returns the comments on a public Reddit post with their replies, in thread order and a page at a time, from the post's link or ID. Each has its text, author, posting and edit time, score (upvotes), depth and parent, awards, and whether it is by the post's author, pinned, a moderator's, collapsed or deleted. Sort by Reddit's own order, New, Old, Top, Controversial or Q&A. A comment's permalink returns that comment and its replies. GET `/v1/reddit/comments` [Read the API reference](https://socialtap.dev/docs/reference/reddit/comments/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **16 typed fields** null when unknown - **200** post comments and replies per page, Reddit's own order for the post (Best, or the order its moderators suggest), each comment followed by the replies Reddit shows - **`url`** is all it needs, e.g. `https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/` ## Send one request. Get up to 200 post comments and replies back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `url = https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/` [Open in playground](https://socialtap.dev/playground/?endpoint=reddit.comments) cURL: ```shell curl -G 'https://socialtap.dev/v1/reddit/comments' \ --data-urlencode 'sort=relevance' \ --data-urlencode 'url=https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.reddit.comments.list({ url: "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/", sort: "relevance" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ sort: "relevance", url: "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/", }); const res = await fetch(`https://socialtap.dev/v1/reddit/comments?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/reddit/comments", params={"sort": "relevance", "url": "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("sort", "relevance") q.Set("url", "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/reddit/comments?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "author": { "avatar_url": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_3.png", "display_name": null, "id": "t2_60d4r", "is_verified": null, "url": "https://www.reddit.com/user/gobearss/", "username": "gobearss" }, "edited_at": null, "id": "t1_c60mmaf", "is_by_post_author": false, "is_edited": false, "is_liked_by_author": null, "is_pinned": false, "metrics": { "like_count": 1556, "reply_count": null }, "parent_id": null, "platform": "reddit", "platform_specific": { "reddit": { "award_count": null, "depth": 0, "distinguished": null, "is_collapsed": false, "is_deleted": false, "more_replies_count": 8, "post": null, "reply_to_author": null, "score": 1556, "subreddit": { "id": "t5_2qzb6", "name": "IAmA", "url": "https://www.reddit.com/r/IAmA/" } } }, "post_id": "t3_z1c9z", "published_at": "2012-08-29T20:05:19Z", "text": "How do you balance family life and hobbies with, well, being the POTUS?", "unknown_fields": [], "url": "https://www.reddit.com/r/IAmA/comments/z1c9z/comment/c60mmaf/" }, { "approximate_fields": [], "author": { "avatar_url": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_2.png", "display_name": null, "id": "t2_8t1cq", "is_verified": null, "url": "https://www.reddit.com/user/PresidentObama/", "username": "PresidentObama" }, "edited_at": null, "id": "t1_c60nmtc", "is_by_post_author": true, "is_edited": false, "is_liked_by_author": null, "is_pinned": false, "metrics": { "like_count": 2951, "reply_count": null }, "parent_id": "t1_c60mmaf", "platform": "reddit", "platform_specific": { "reddit": { "award_count": null, "depth": 1, "distinguished": null, "is_collapsed": false, "is_deleted": false, "more_replies_count": 285, "post": null, "reply_to_author": null, "score": 2951, "subreddit": { "id": "t5_2qzb6", "name": "IAmA", "url": "https://www.reddit.com/r/IAmA/" } } }, "post_id": "t3_z1c9z", "published_at": "2012-08-29T21:04:58Z", "text": "It's hard - truthfully the main thing other than work is just making sure that I'm spending enough time with michelle and the girls. The big advantage I have is that I live above the store - so I have no commute! So we make sure that when I'm in DC I never miss dinner with them a…", "unknown_fields": [], "url": "https://www.reddit.com/r/IAmA/comments/z1c9z/comment/c60nmtc/" }, { "approximate_fields": [], "author": { "avatar_url": null, "display_name": "[deleted]", "id": null, "is_verified": null, "url": null, "username": null }, "edited_at": null, "id": "t1_c60npsu", "is_by_post_author": null, "is_edited": null, "is_liked_by_author": null, "is_pinned": false, "metrics": { "like_count": null, "reply_count": null }, "parent_id": "t1_c60nmtc", "platform": "reddit", "platform_specific": { "reddit": { "award_count": null, "depth": 2, "distinguished": null, "is_collapsed": false, "is_deleted": true, "more_replies_count": 33, "post": null, "reply_to_author": null, "score": null, "subreddit": { "id": "t5_2qzb6", "name": "IAmA", "url": "https://www.reddit.com/r/IAmA/" } } }, "post_id": "t3_z1c9z", "published_at": "2012-08-29T21:11:23Z", "text": "", "unknown_fields": [], "url": "https://www.reddit.com/comments/z1c9z/comment/c60npsu/" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "reddit", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 667, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "post", "id": "t3_z1c9z", "url": "https://www.reddit.com/comments/z1c9z/" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 9 platforms. The [response reference](https://socialtap.dev/docs/reference/reddit/comments/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/comment/index.md). - ### Null means unknown A field Reddit doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts Reddit post URL: a post's page on any reddit.com host (www, old, new, np, m, sh), with or without its subreddit or slug, a /gallery/ link, a redd.it short link, an app share link (/r/\/s/\), a v.redd.it video link, or the post's ID (t3_ prefix optional). - ### Write one parser Reddit, TikTok, Instagram and 6 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native comment ID (string; Reddit with its t1_ prefix). - **`post_id`string**: ID of the post commented on (equals post.id). - **`parent_id`string**: ID of the comment this replies to; null for top-level comments. - **`url`string**: Permalink, when the platform has one. - **`text`string**: Comment body as plain text. - **`author`object**: The commenting account. An account the platform no longer names (a deleted account) has a null id and username and the platform's label as display_name (Reddit: \[deleted\]). - **`published_at`string**: When the comment was posted, RFC 3339 UTC. Where the platform shows only a relative time ("3 weeks ago"), the latest time that label allows (the fetch time minus the stated amount), listed in approximate_fields. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Reddit Comments API. - ### Analyze the discussion under a post - ### Collect the answers in an AMA - ### Follow the replies to one comment - ### Summarize a thread with AI ## Good to know before you build. - Comments come in thread order: each one is followed by the replies Reddit shows under it, and parent_id and platform_specific.reddit.depth place it in the thread. - Where Reddit shows a "more replies" link, platform_specific.reddit.more_replies_count says how many replies it holds back. The next pages bring them before the post's next top-level comment, so a walk to the end returns the whole tree. - Walking the whole tree takes several times the requests of replies=shown, because Reddit sends held-back replies a few at a time. replies=shown skips them. - On a thread with hundreds of top-level comments, a walk can leave the most deeply nested held-back replies out once its cursor is full. That page carries an items_omitted warning, more_replies_count still counts them, and that comment's url pages through them. - metrics.like_count is the comment's score (upvotes minus downvotes) when it isn't negative, and platform_specific.reddit.score has it either way. metrics.reply_count is the comment's direct replies when the page shows all of them. It is null when Reddit holds some back behind a "more replies" link, whose count includes their own replies. - Each page continues where the last one ended, so on a busy thread a comment posted during your walk can appear on a later page out of order, never twice. - A deleted account is author {display_name: "\[deleted\]"} with every other author field null. A deleted or removed comment that has replies stays in the thread with empty text and platform_specific.reddit.is_deleted true. - Posts that don't exist and posts of banned subreddits return not_found. Posts of private or quarantined subreddits return private_or_unavailable. A permalink to a comment that isn't in the post returns not_found. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/reddit/comments/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Public page `page` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Reddit Comments API. More in the [API reference](https://socialtap.dev/docs/reference/reddit/comments/index.md). **Does it return nested replies?** Yes. With replies=all, the default, a walk to the last page returns the whole tree, including the replies Reddit hides behind "more replies" links. **How much does the Reddit Comments API cost?** A page of up to 200 post comments and replies costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. Other platforms ## Comments on 8 more platforms. - [TikTok Comments API](https://socialtap.dev/apis/tiktok/comments/index.md) (1 credit / page · `GET /v1/tiktok/comments`) - [Instagram Comments API](https://socialtap.dev/apis/instagram/comments/index.md) (1 credit / page · `GET /v1/instagram/comments`) - [Facebook Comments API](https://socialtap.dev/apis/facebook/comments/index.md) (1 credit / page · `GET /v1/facebook/comments`) - [YouTube Comments API](https://socialtap.dev/apis/youtube/comments/index.md) (1 credit / page · `GET /v1/youtube/comments`) - [Threads Comments API](https://socialtap.dev/apis/threads/comments/index.md) (1 credit / page · `GET /v1/threads/comments`) - [Rumble Comments API](https://socialtap.dev/apis/rumble/comments/index.md) (1 credit / page · `GET /v1/rumble/comments`) - [Bluesky Comments API](https://socialtap.dev/apis/bluesky/comments/index.md) (1 credit / page · `GET /v1/bluesky/comments`) - [Snapchat Comments API](https://socialtap.dev/apis/snapchat/comments/index.md) (1 credit / page · `GET /v1/snapchat/comments`) More Reddit ## Reddit API. 13 endpoints, one key. - [Reddit Post API](https://socialtap.dev/apis/reddit/post/index.md) (1 credit · `GET /v1/reddit/post`) - [Reddit Search API](https://socialtap.dev/apis/reddit/search_posts/index.md) (1 credit / page · `GET /v1/reddit/search_posts`) - [Reddit User Posts API](https://socialtap.dev/apis/reddit/posts/index.md) (1 credit / page · `GET /v1/reddit/posts`) - [Reddit Subreddit Posts API](https://socialtap.dev/apis/reddit/subreddit_posts/index.md) (1 credit / page · `GET /v1/reddit/subreddit_posts`) - [Reddit Profile API](https://socialtap.dev/apis/reddit/profile/index.md) (1 credit · `GET /v1/reddit/profile`) - [Reddit User Search API](https://socialtap.dev/apis/reddit/search_profiles/index.md) (1 credit / page · `GET /v1/reddit/search_profiles`) - [Reddit User Comments API](https://socialtap.dev/apis/reddit/profile_comments/index.md) (1 credit / page · `GET /v1/reddit/profile_comments`) - [Reddit Comment Search API](https://socialtap.dev/apis/reddit/search_comments/index.md) (1 credit / page · `GET /v1/reddit/search_comments`) - [Reddit Video Transcript API](https://socialtap.dev/apis/reddit/transcript/index.md) (From 1 credit · `GET /v1/reddit/transcript`) - [Reddit Engagement API](https://socialtap.dev/apis/reddit/engagement/index.md) (1 credit · `GET /v1/reddit/engagement`) - [Reddit Subreddit API](https://socialtap.dev/apis/reddit/subreddit/index.md) (1 credit · `GET /v1/reddit/subreddit`) - [Reddit Subreddit Search API](https://socialtap.dev/apis/reddit/search_subreddits/index.md) (1 credit / page · `GET /v1/reddit/search_subreddits`) ## Try it on a link you already have. Paste it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/reddit/comments/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)