Skip to content

Reddit Comment Search

GET/v1/reddit/comments/search
MCPreddit_search_comments2 creditsLive

Updated

Description

Search Reddit comments by keyword, the place where people actually recommend and complain about tools. Returns comment text, author, score, subreddit, the parent post title and a link. Costs 2 credits per page. Tip: comments have no time filter upstream, so sort=new and stop paging once results get older than you need.

Parameters

q query, string, required
Search text. Reddit operators allowed.
sort query, enum
Result order. Comments have no time filter, so use new to monitor. One of: relevance, new, top. Default relevance.
author query, string
Only comments by this username.
nsfw query, boolean,string
Include comments from adult communities. true needs the 18+ setting.
limit query, integer
Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page. Range 1 to 100. Default 25.
cursor query, string
Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.

Request examples

curl "https://chatterapi.com/v1/reddit/comments/search?q=gummysearch+alternative" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

Response

data is a list of RedditComment, with page.nextCursor and page.hasMore for the next page. Fields:

FieldTypeNullableDescription
idstringnoPlatform id.
fullnamestringnoReddit fullname (t3_ for posts, t1_ for comments). Dedupe on this.
parentIdstringyesFullname of the parent comment or post.
postIdstringyesId of the post this comment belongs to.
postTitlestringyesTitle of that post.
authorstringyesAuthor username, null when deleted.
bodystringnoText body. Empty for link and media posts.
bodyTruncatedbooleannoTrue when the text is a preview from a fallback source.
scorenumberyesScore (upvotes minus downvotes) as Reddit reports it.
subredditstringyesSubreddit name without r/.
permalinkstringyesPath on reddit.com.
urlstringyesFull URL on the platform.
createdAtstringnoISO 8601 UTC timestamp.
response
{
  "data": [
    {
      "id": "j01f68f",
      "fullname": "t1_j01f68f",
      "parentId": null,
      "postId": "zk2soo",
      "postTitle": "I think quite a lot of people in this subreddit ARE entrepreneurs",
      "author": "esoemah",
      "body": "I know the guy already answered your question, but I’d like to offer an alternative that you could consider as well: social listening. Basically, you’d monitor social media for any mentions of keywords relevant to your business, then engage with these people. I’d recommend checking out the following tools for this: F5bot (it’s free, scans entirety of Reddit) MentionFunnel (full disclosure, I built it. It has a free tier and you can filter by specific subreddits and in the future also other platforms such as HN and Twitter) GummySearch (very good for audience research, also has keyword tracking and a free tier iirc)",
      "bodyTruncated": false,
      "score": 2,
      "subreddit": "Entrepreneur",
      "permalink": "/r/Entrepreneur/comments/zk2soo/i_think_quite_a_lot_of_people_in_this_subreddit/j01f68f/",
      "url": "https://www.reddit.com/r/Entrepreneur/comments/zk2soo/i_think_quite_a_lot_of_people_in_this_subreddit/j01f68f/",
      "createdAt": "2022-12-13T11:30:40.000Z"
    },
    {
      "id": "le642mq",
      "fullname": "t1_le642mq",
      "parentId": null,
      "postId": "1e86dz5",
      "postTitle": "[NBA] LeBron and Curry in the tunnel following the win: Lebron - \"To be honest I like those ones more than the blowouts...I like being tested baby.\" Curry - \"Put the closer on.\"",
      "author": "EyePlay",
      "body": "The sub is just bigger and Silver has turned the NBA into the social media consumed sport. Unless you want to talk hoops on twitter, reddit has become the main NBA hub over the last ten years. People who consume the NBA primarily through social media (including this subreddit) are a lot different than people who watch games and then are looking for a place of discussion. And there is a difference between the two. I became active later than you guys. Think I more or less stopped using RealGM and ISH in 2016 because the player only fans + alt accounts was making things unbearable. And I remember the threads on r/nba then on how it was consistently near the top of reddit in growth. Like in 2013 r/nba had 98,103 members. Now we have 12,159,356 members. In 2016, around the time I joined, r/nba was 99th in total members and under 2m. Can't figure out the exact as that data is, in fact, not beautiful. According to this r/nba is 10th in member growth just in this past year. 4.2m+ more members. eta ^ got automodded because my reddit links were np and idk wtf that means so I'm just not going to link them. Believe me or google it yourself lol. Basically: way bigger community (and it's a HUGE community now) + about a decade worth of results on how the NBA has decided they want to be watched and here we are. Not that anyone asked for my opinion, but if you can't tell I think what the NBA has decided to do has created worse fans, while also way more fans than they would have alternatively so I don't blame them. It worked, I guess.",
      "bodyTruncated": false,
      "score": 6,
      "subreddit": "nba",
      "permalink": "/r/nba/comments/1e86dz5/nba_lebron_and_curry_in_the_tunnel_following_the/le642mq/",
      "url": "https://www.reddit.com/r/nba/comments/1e86dz5/nba_lebron_and_curry_in_the_tunnel_following_the/le642mq/",
      "createdAt": "2024-07-21T02:10:00.000Z"
    },
    {
      "id": "nouhnb2",
      "fullname": "t1_nouhnb2",
      "parentId": null,
      "postId": "1dm74nv",
      "postTitle": "Please make a free version of gummysearch and instead make money through ads.",
      "author": "Strong_Teaching8548",
      "body": "I made this one and you can try it our free :) It's an AI agent connected to reddit, quora, bhw and more forums & social media soon!!",
      "bodyTruncated": false,
      "score": 1,
      "subreddit": "SomebodyMakeThis",
      "permalink": "/r/SomebodyMakeThis/comments/1dm74nv/please_make_a_free_version_of_gummysearch_and/nouhnb2/",
      "url": "https://www.reddit.com/r/SomebodyMakeThis/comments/1dm74nv/please_make_a_free_version_of_gummysearch_and/nouhnb2/",
      "createdAt": "2025-11-14T18:05:19.000Z"
    }
  ],
  "page": {
    "nextCursor": "eyJ2IjoxLCJwIjoiY2l0ZXJvY2tldCIsImMiOiJleUpqWVc1a2FXUmhkR1Z6WDNKbGRIVnlibVZrSWpvaWUxd2ljMlZqZEdsdmJsOHhYM0JwY0dWc2FXNWxYekJmWjJ4dlltRnNYMjF2WkdsbWFXVnljMXdpT2x3aU1Wd2lMRndpYzJWamRHbHZibDh4WDNCcGNHVnNhVzVsWHpGZmJHOWpZV3hmYlc5a2FXWnBaWEp6WENJNlhDSXhYQ0lzWENKelpXTjBhVzl1WHpKZmNHbHdaV3hwYm1WZk1WOWpiMjF0Wlc1MFgzTmxZWEpqYUZ3aU9sd2lOVndpZlNJc0ltVjRjR1Z5YVdWdVkyVmZjMlZzWldOMGFXOXVJam9pWTI5dGJXVnVkQ0lzSW1WNGNHVnlhV1Z1WTJWZmRtVnljMmx2YmlJNkltUmxabUYxYkhRaUxDSnpaV04wYVc5dVh6SmZjR2x3Wld4cGJtVmZNVjlqYjIxdFpXNTBYM05sWVhKamFDSTZJakV3SW4wPSIsIm8iOjAsImgiOiI3ZDZlOGIxYjNmZmEifQ",
    "hasMore": true
  },
  "credits": {
    "charged": 2,
    "remaining": 24997
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
  "cached": false
}

Recorded live response captured 2026-10-07, truncated to 3 items. Credits and request id are illustrative.

Credits

2 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 10 minutes are served from cache.

Errors this tool can return

Try it