# Reddit Comment Search API. Comments matching your search. Comments by keyword, sitewide or in a subreddit. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dreddit.search_comments) ## Reddit Comment Search API at a glance Searches public Reddit comments by keyword, across Reddit or in one subreddit, sorted by best match, newest or top. Each has its text, permalink, author and avatar, time, exact score and the comment it replies to, with the post it is on (title, link, score, comment count, NSFW and spoiler marks) and its subreddit. GET `/v1/reddit/search_comments` [Read the API reference](https://socialtap.dev/docs/reference/reddit/search_comments/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **16 typed fields** null when unknown - **10** comments per page, Reddit's search ranking (best match) - **`query`** is all it needs, e.g. `golang` ## Send one request. Get up to 10 comments 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` `query = golang` [Open in playground](https://socialtap.dev/playground/?endpoint=reddit.search_comments) cURL: ```shell curl 'https://socialtap.dev/v1/reddit/search_comments?query=golang' \ -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.searchComments.list({ query: "golang" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ query: "golang", }); const res = await fetch(`https://socialtap.dev/v1/reddit/search_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/search_comments", params={"query": "golang"}, 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("query", "golang") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/reddit/search_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_4.png", "display_name": null, "id": null, "is_verified": null, "url": "https://www.reddit.com/user/TheHeretic/", "username": "TheHeretic" }, "edited_at": null, "id": "t1_19rgj26rxh943", "is_by_post_author": null, "is_edited": null, "is_liked_by_author": null, "is_pinned": null, "metrics": { "like_count": 391, "reply_count": null }, "parent_id": null, "platform": "reddit", "platform_specific": { "reddit": { "award_count": null, "depth": null, "distinguished": null, "is_collapsed": null, "is_deleted": null, "more_replies_count": null, "post": { "comment_count": 633, "is_nsfw": false, "is_spoiler": false, "published_at": "2026-10-21T23:38:18Z", "score": 1258, "title": "Aside from hacking TVs to remove ads, what’s another cool/innovative way you’ve used claude to boost your quality of life", "url": "https://www.reddit.com/r/ClaudeAI/comments/1xc31hj/aside_from_hacking_tvs_to_remove_ads_whats/" }, "reply_to_author": null, "score": 391, "subreddit": { "id": "t5_7t8hvt", "name": "ClaudeAI", "url": "https://www.reddit.com/r/ClaudeAI/" } } }, "post_id": "t3_1xc31hj", "published_at": "2026-10-22T00:29:40Z", "text": "Reverse engineering Microsoft teams to make a golang version that only uses ~120mb of RAM as compared to 3GiB on Mac", "unknown_fields": [], "url": "https://www.reddit.com/r/ClaudeAI/comments/1xc31hj/aside_from_hacking_tvs_to_remove_ads_whats/19rgj26rxh943/" }, { "approximate_fields": [], "author": { "avatar_url": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_3.png", "display_name": null, "id": null, "is_verified": null, "url": "https://www.reddit.com/user/Conflict-Mother/", "username": "Conflict-Mother" }, "edited_at": null, "id": "t1_19s0zx668qjgj", "is_by_post_author": null, "is_edited": null, "is_liked_by_author": null, "is_pinned": null, "metrics": { "like_count": 1, "reply_count": null }, "parent_id": "t1_19s0zmg6ic9hh", "platform": "reddit", "platform_specific": { "reddit": { "award_count": null, "depth": null, "distinguished": null, "is_collapsed": null, "is_deleted": null, "more_replies_count": null, "post": { "comment_count": 17, "is_nsfw": false, "is_spoiler": false, "published_at": "2026-11-02T11:19:09Z", "score": 0, "title": "Synology has abandaned beloved VideoStation, now I re-create it", "url": "https://www.reddit.com/r/synology/comments/1xlujkl/synology_has_abandaned_beloved_videostation_now_i/" }, "reply_to_author": null, "score": 1, "subreddit": { "id": "t5_2s4co", "name": "synology", "url": "https://www.reddit.com/r/synology/" } } }, "post_id": "t3_1xlujkl", "published_at": "2026-11-02T11:50:12Z", "text": "yes single binary is the most gain from. In idle status, MyVideoStation in docker occupy about 25MB mem as I see, and even when scanning golang's mem gc is working very well. Because of all htmls are served from embed, it is blazing fast too.", "unknown_fields": [], "url": "https://www.reddit.com/r/synology/comments/1xlujkl/synology_has_abandaned_beloved_videostation_now_i/19s0zx668qjgj/" }, { "approximate_fields": [], "author": { "avatar_url": "https://www.redditstatic.com/shreddit/assets/avatar_over18.png", "display_name": null, "id": null, "is_verified": null, "url": "https://www.reddit.com/user/lispLaiBhari/", "username": "lispLaiBhari" }, "edited_at": null, "id": "t1_19s0kg7kv3uzp", "is_by_post_author": null, "is_edited": null, "is_liked_by_author": null, "is_pinned": null, "metrics": { "like_count": 1, "reply_count": null }, "parent_id": "t1_19s0jm74i7yxx", "platform": "reddit", "platform_specific": { "reddit": { "award_count": null, "depth": null, "distinguished": null, "is_collapsed": null, "is_deleted": null, "more_replies_count": null, "post": { "comment_count": 13, "is_nsfw": false, "is_spoiler": false, "published_at": "2026-11-02T05:33:45Z", "score": 7, "title": "Kuberenetes home lab suggestion", "url": "https://www.reddit.com/r/kubernetes/comments/1xlozgi/kuberenetes_home_lab_suggestion/" }, "reply_to_author": null, "score": 1, "subreddit": { "id": "t5_33f68", "name": "kubernetes", "url": "https://www.reddit.com/r/kubernetes/" } } }, "post_id": "t3_1xlozgi", "published_at": "2026-11-02T06:03:20Z", "text": "Thanks. So i want to learn Kubernetes along with CI/CD. Currently working in golang application side but wanted to do this setup and experiment.\n\nOne laptop and one mini-PC(mid range), will this suffice to experiment on prem K8S/CI/CD?", "unknown_fields": [], "url": "https://www.reddit.com/r/kubernetes/comments/1xlozgi/kuberenetes_home_lab_suggestion/19s0kg7kv3uzp/" } ], "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": 581, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "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/search_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 Words to find in comment text, matched by Reddit's own search. - ### 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 Comment Search API. - ### Track what commenters say about a brand - ### Find the most upvoted opinions on a topic - ### Collect comments for social listening ## Good to know before you build. - The post each comment is on is in platform_specific.reddit.post (its ID is post_id), and the subreddit in platform_specific.reddit.subreddit. - A comment's score can be negative: platform_specific.reddit.score has it, and metrics.like_count is then null. Reddit's search shows no reply count, so reply_count is null. - A subreddit that doesn't exist, one Reddit banned and a quarantined one (which Reddit keeps out of logged-out search) find nothing: the page is empty with end_reason end. So does a query of operators alone, such as author:\ without words. - Relevance is Reddit's own ranking and can change between requests. Newest is ordered by time, so since stops the walk there. ## 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/search_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 Comment Search API. More in the [API reference](https://socialtap.dev/docs/reference/reddit/search_comments/index.md). **How much does the Reddit Comment Search API cost?** A page of up to 10 comments 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 Comment API](https://socialtap.dev/apis/tiktok/comment/index.md) (1 credit · `GET /v1/tiktok/comment`) - [Instagram Comment API](https://socialtap.dev/apis/instagram/comment/index.md) (1 credit · `GET /v1/instagram/comment`) - [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 Comments API](https://socialtap.dev/apis/reddit/comments/index.md) (1 credit / page · `GET /v1/reddit/comments`) - [Reddit User Comments API](https://socialtap.dev/apis/reddit/profile_comments/index.md) (1 credit / page · `GET /v1/reddit/profile_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 with your own search. Type 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/search_comments/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)