Introducing the Instagram APIRead more →

Reddit Comment Search API. Comments matching your search.

Comments by keyword, sitewide or in a subreddit. We handle the proxies, blocks and platform changes.

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
  • 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
GET /v1/reddit/search_commentsTry in
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);
200 OK · GET https://socialtap.dev/v1/reddit/search_commentsLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 9 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

  • 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.

platformstring
Platform ID (tiktok, youtube, …).
idstring
Platform-native comment ID (string; Reddit with its t1_ prefix).
post_idstring
ID of the post commented on (equals post.id).
parent_idstring
ID of the comment this replies to; null for top-level comments.
urlstring
Permalink, when the platform has one.
textstring
Comment body as plain text.
authorobject
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_atstring
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.

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:<name> 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.

SourcePrice per successful pagePer 1,000 pages
Public page page1 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.

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.

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 Read the docs