RedditapisRedditapis
Posts

Get Reddit Post Comments by Permalink

Fetch the full comment tree for a Reddit post by permalink — every top-level comment, nested reply, upvotes, and author metadata in one HTTP GET call.

GET/api/reddit/comments$0.002 / call

Full comment tree for a post by permalink. Returns a clean wrapper with the post, native Reddit comment tree nodes, and a pagination cursor.

Query Parameters

ParameterTypeRequiredDescription
permalinkstringYesPost permalink (e.g. /r/X/comments/abc/title/)

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/api/reddit/comments?permalink=/r/ClaudeCode/comments/1sgjld3/"
const response = await fetch(
  "https://api.redditapis.com/api/reddit/comments?permalink=/r/ClaudeCode/comments/1sgjld3/",
  { headers: { Authorization: "Bearer TOKEN" } }
);
import requests

response = requests.get(
    "https://api.redditapis.com/api/reddit/comments",
    params={"permalink": "/r/ClaudeCode/comments/1sgjld3/"},
    headers={"Authorization": "Bearer TOKEN"},
)

Response Shape

{
  "post": { "...": "same post shape as /api/reddit/post/:id" },
  "comments": [
    {
      "kind": "t1",
      "data": { "id": "abc", "body": "...", "author": "user123" }
    }
  ],
  "after": null
}

comments is Reddit's native comment tree — each node has kind: "t1" and data.replies containing child comments. post follows the posts field shape.

Fetch by post ID instead of permalink

If you already have the post ID and not the full permalink, call the ID form. It returns the exact same response shape at the same price, so you never have to build a permalink just to read a thread.

GET/api/reddit/comments/{postId}$0.002 / call
ParameterTypeRequiredDescription
postIdstringYesReddit post id (e.g. 1sgjld3)
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/api/reddit/comments/1sgjld3"

This is an alias of GET /api/reddit/post/{postId}/comments — both run the same handler. All three of these return the same thing:

URL shapeUse when
GET /api/reddit/comments?permalink=/r/{sub}/comments/{postId}/You have the permalink
GET /api/reddit/post/{postId}/commentsYou have the post ID
GET /api/reddit/comments/{postId}You have the post ID

Adding the ID form did not change the permalink form above — it still works exactly as documented, and existing integrations need no changes.

Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.

On this page