Subreddit Comments API

List the newest comments posted across a subreddit, with the text, author and score of each and the post it was left on. Page through results with `cursor`.

Endpoint: POST /reddit/list-subreddit-comments
Price: 1 credit per request
SDK: client.reddit.listSubredditComments()
MCP tool: reddit_list_subreddit_comments

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/reddit/list-subreddit-comments" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "subreddit": "programming",
  "count": 10
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/reddit/list-subreddit-comments",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "subreddit": "programming",
        "count": 10,
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/reddit/list-subreddit-comments", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "subreddit": "programming",
    "count": 10
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.reddit.listSubredditComments({
  subreddit: "programming",
  count: 10
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Subreddit Comments API return?

Subreddit comments API: get the newest comments posted anywhere in a subreddit, with text, author, score and the post each one was left on, as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

subredditstringrequired: Subreddit name, with or without the "r/" prefix, or the subreddit link, e.g. "programming" or "https://www.reddit.com/r/programming/".
countinteger · 1–10 · default 10: Number of results to return (1–10). Defaults to 10.
cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "comments": [
      {
        "id": "string",
        "fullname": "string",
        "author": "string",
        "authorFullname": "string",
        "authorFlairText": "string",
        "body": "string",
        "score": 0,
        "ups": 0,
        "downs": 0,
        "scoreHidden": true,
        "controversiality": 0,
        "totalAwardsReceived": 0,
        "gilded": 0,
        "createdUtc": 0,
        "createdAt": "string",
        "editedUtc": 0,
        "editedAt": "string",
        "permalink": "string",
        "commentUrl": "string",
        "depth": 0,
        "isSubmitter": true,
        "stickied": true,
        "collapsed": true,
        "locked": true,
        "distinguished": "string",
        "parentId": "string",
        "postId": "string",
        "postFullname": "string",
        "subreddit": "string",
        "subredditId": "string",
        "subredditPrefixed": "string",
        "subredditType": "string",
        "subredditUrl": "string",
        "replies": [
          {}
        ],
        "linkTitle": "string",
        "linkPermalink": "string",
        "linkAuthor": "string",
        "linkAuthorUrl": "string",
        "linkUrl": "string",
        "linkNumComments": 0,
        "linkOver18": true
      }
    ],
    "subreddit": "string"
  }
}

[ USE CASES ]

What can you build with the Subreddit Comments API?

Real-time monitoring

Catch mentions of your brand in a community within minutes.

Measure activity

Compare how lively different subreddits are by comment volume.

Moderation queues

Review every new comment in a community you moderate.

[ FAQ ]

Subreddit Comments API questions

How do I get the latest comments across a subreddit?

Send the subreddit name. You get its newest comments, up to 10 per call, with text, author, score and the post each was left on; send the nextCursor back as cursor for older ones.

Can I watch a subreddit for mentions of my product?

Yes. Poll the newest comments and check the text for your product or competitor names. To search all of Reddit instead of one community, use the Reddit Comment Search API.

How do I get older comments from a subreddit?

Each call returns up to 10 comments and a nextCursor. Send it back as cursor to get the next 10; it is null once there are no more.

How do I use the Subreddit Comments API?

Send a POST request to https://api.bridgly.app/reddit/list-subreddit-comments with subreddit in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.reddit.listSubredditComments(). AI agents connected to Bridgly over MCP can call the reddit_list_subreddit_comments tool.

How much does the Subreddit Comments API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More Reddit endpoints

The same API key works on every endpoint. See all Reddit API endpoints.

Try the Subreddit Comments API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs