ToolzerHub Docs

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
GET
/v1/reddit/post-comments

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.

Lengthlength <= 300
post_id_or_url*string

The post's reddit.com permalink, or its id (1vqcqpz) or t3_ fullname with subreddit.

Lengthlength <= 500
sort?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.

Length1 <= length <= 8000
curl -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"  }}