Reddit API: List post comments

List a post's comment tree, flattened with depth and parent_fullname on each row, plus Reddit's own comment total. Requires subreddit and post_id; the result may be partial — see unfollowed_branches and truncated_threads.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

subreddit*string

Community the post belongs to, e.g. technology. Accepts r/technology or a URL. It must match the post; a mismatch returns a 500, so pasting the post's permalink into post_id is safest.

Lengthlength <= 300

post_id*string

Post id (1vqcqpz), t3_ fullname, or permalink. Prefer the permalink: it also supplies the community, so the two can't disagree.

Lengthlength <= 500

count?integer

How many distinct comments to return. Collapsed branches are expanded for you. A short result does not always mean the post has no more comments; deep threads can stay hidden.

Range1 <= value <= 200

Default25

sort?string

Comment order: top, new, controversial or old. Omit it for Reddit's default (best).

Value in

"top"
"new"
"controversial"
"old"

curl -X GET "https://example.com/v1/reddit/post-comments?subreddit=technology&post_id=1vqcqpz" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "comments": [      {        "kind": "comment",        "id": "p44qdpd",        "fullname": "t1_p44qdpd",        "parent_fullname": "t1_p44qab1",        "post_fullname": "t3_1vqcqpz",        "depth": 0,        "position": 3,        "parent_positions": [          0,          0        ],        "author": "example_user",        "author_icon": null,        "body": "This is the comment text as rendered.",        "score": 42,        "created_at": "2026-08-17T09:14:22.000+0000",        "permalink": "/r/technology/comments/1vqcqpz/example/p44qdpd/",        "award_count": 0,        "is_deleted": false,        "is_collapsed": false      }    ],    "subreddit": "technology",    "post_id": "1vqcqpz",    "post_fullname": "t3_1vqcqpz",    "permalink": "/r/technology/comments/1vqcqpz/example_post_title/",    "sort": "CONFIDENCE",    "total_comments": 226,    "count": 25,    "requested_count": 25,    "end_of_tree": false,    "unfollowed_branches": 14,    "truncated_threads": 0,    "pages_fetched": 3,    "usage_note": "Comments come back FLAT in prefix order, each carrying `depth` and `parent_fullname` — Reddit states both, neither is inferred from indentation — so a nested tree can be rebuilt exactly. The 'load more' cursors are a tree rather than a chain: one batch hands back several and this queues all of them, so `end_of_tree` is false while `unfollowed_branches` is non-zero. `truncated_threads` counts subtrees Reddit only links to by permalink and gives no cursor for; those need a separate request against that permalink."  }}