List post comments (v1)
List one batch of a post's comment tree, flattened with depth and parent_fullname. Requires post_id_or_url (and subreddit for a bare id); pass an entry of next_cursors as cursor to load a collapsed branch.
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. Needed only when post_id_or_url is a bare id; a permalink names it already. It must match the post: a mismatch returns a 500.
Length
length <= 300post_id_or_url*string
The post's reddit.com permalink, or its id (1vqcqpz) or t3_ fullname with subreddit.
Length
length <= 500sort?string
Comment order: top, new, controversial or old. Omit it for Reddit's default (best).
Value in
- "top"
- "new"
- "controversial"
- "old"
cursor?string
One entry of next_cursors from a previous response, to load that collapsed branch. Omit for the top-level comments.
Length
1 <= length <= 8000curl -X GET "https://example.com/v1/reddit/post-comments?post_id_or_url=https%3A%2F%2Fwww.reddit.com%2Fr%2Ftechnology%2Fcomments%2F1vqcqpz%2Fsome_slug%2F" \ -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, "next_cursors": [ "commenttree:ex1", "commenttree:ex2" ], "end_of_tree": false, "unfollowed_branches": 14, "truncated_threads": 0, "usage_note": "One batch of the comment tree, FLAT in prefix order with `depth` and `parent_fullname`, so the nesting can be rebuilt. 'Load more' cursors form a tree: pass each entry of `next_cursors` as `cursor` (one request each) to expand that branch. `truncated_threads` counts subtrees Reddit only links by permalink." }, "details": { "reason": "no_results", "message": "string" }}