Reddit Comment API

Get a single Reddit comment from its permalink, together with the post it was left on and the replies beneath it.

Endpoint: POST /reddit/get-comment
Price: 1 credit per request
SDK: client.reddit.getComment()
MCP tool: reddit_get_comment

Terminal

$curl -X POST "https://api.bridgly.app/reddit/get-comment" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "permalink": "/r/programming/comments/1u3a0cd/title/labc123/"
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/reddit/get-comment",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "permalink": "/r/programming/comments/1u3a0cd/title/labc123/",
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/reddit/get-comment", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "permalink": "/r/programming/comments/1u3a0cd/title/labc123/"
  }),
});
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.getComment({
  permalink: "/r/programming/comments/1u3a0cd/title/labc123/"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Reddit Comment API return?

Reddit comment API: get one comment from its permalink as JSON, together with the replies beneath it and the post it was left on, in a single call. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

permalinkstringrequired: Permalink of the Reddit comment to fetch — an absolute URL or a site-relative path, e.g. "/r/programming/comments/1u3a0cd/title/labc123/".
sortenum: Ordering of the replies. Defaults to the subreddit's suggested sort, usually "best".; best | top | new | controversial | old | qa

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "post": {
      "id": "string",
      "fullname": "string",
      "title": "string",
      "author": "string",
      "authorFullname": "string",
      "selftext": "string",
      "score": 0,
      "ups": 0,
      "downs": 0,
      "upvoteRatio": 0,
      "numComments": 0,
      "numCrossposts": 0,
      "totalAwardsReceived": 0,
      "gilded": 0,
      "createdUtc": 0,
      "createdAt": "string",
      "editedUtc": 0,
      "editedAt": "string",
      "permalink": "string",
      "postUrl": "string",
      "url": "string",
      "subreddit": "string",
      "subredditId": "string",
      "subredditUrl": "string",
      "subredditPrefixed": "string",
      "subredditSubscribers": 0,
      "subredditType": "string",
      "linkFlairText": "string",
      "domain": "string",
      "thumbnail": "string",
      "distinguished": "string",
      "isSelf": true,
      "isVideo": true,
      "isOriginalContent": true,
      "over18": true,
      "spoiler": true,
      "stickied": true,
      "pinned": true,
      "archived": true,
      "contestMode": true,
      "locked": true
    },
    "comment": {
      "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": [
        {}
      ]
    }
  }
}

[ USE CASES ]

What can you build with the Reddit Comment API?

Quote a reply in context

Fetch a linked comment together with the post it answers.

Follow a sub-thread

Read the replies under one comment without loading the whole post.

Verify citations

Check that a comment still exists and what it says now.

[ FAQ ]

Reddit Comment API questions

How do I get a single Reddit comment and its replies?

Send the comment’s permalink, either the full URL or a path such as /r/programming/comments/1u3a0cd/title/labc123/. You get the comment, the replies beneath it and the post it was left on.

Where do I find a comment’s permalink?

Click Share on the comment and copy the link, or take it from the Reddit Comment Search API, which returns a link for each comment it finds.

How do I use the Reddit Comment API?

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

How much does the Reddit Comment 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 Reddit Comment 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