← API Store
SocialReddit
Comments of a Reddit post
GET /reddit/v1/commentsThe post's comment tree (25 top-level threads per page). next_cursor loads the next top-level comments; more_replies lists the reply threads Reddit folded, each with its own cursor for this route. next_cursor is null on the last page. depth keeps only comments down to that reply level (0 = top-level only). Every response includes credits_used: the credits this call cost.
Each call costs 2 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
url | string | Post URL (instead of subreddit + post_id). Example: https://www.reddit.com/r/Python/comments/1x89bnq/ |
subreddit | string | Example: Python |
post_id | string | Example: 1x89bnq |
sort | best | confidence | top | new | controversial | old | qa | Comment sort: best (confidence), top (default), new, controversial, old, qa. Example: top |
post_url | string | Same as `url`. |
tree | 0 | 1 | 1 adds `comment_tree`: the same comments nested, each with its `replies` and folded `more_replies`. |
cursor | string | `next_cursor` from the previous page (more top-level comments), or a `more_replies[].cursor` (the replies Reddit folded under that comment). |
depth | integer | Deepest reply level to return: 0 = top-level comments only, 1 = and their direct replies, and so on. `more_replies` then lists only threads above that level. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"comments": [
{
"attributes": {
"ariaLabel": "Comment from ConcreteExist 6 days ago",
"author": "ConcreteExist",
"avatar": "https://styles.redditmedia.com/t5_eke9l/styles/profileIcon_mphxsqljvnnc1.png?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=f14…",
"class": "relative [contain:style] col-start-2",
"comment-parent-positions": "[]",
"comment-position": "0",
"content-type": "text",
"created": "2026-10-17T12:45:42.394000+0000",
"depth": "0",
"highlight-variant": "",
"paid-award-only-comment-highlighting-enabled": true,
"permalink": "/r/Python/comments/1x89bnq/comment/phan1k9/",
"postId": "t3_1x89bnq",
"record-ttci": true,
"reload-url": "/svc/shreddit/comment/t1_phan1k9?depth=0&subredditName=Python",
"score": "43",
"thingId": "t1_phan1k9"
},
"author": "ConcreteExist",
"author_avatar": "https://styles.redditmedia.com/t5_eke9l/styles/profileIcon_mphxsqljvnnc1.png?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=f14…",
"body": "Admittedly, I've only ever used base64 encoding out of all of those listed here, happy to see it's performance improving though.",
"body_html": "<div id=\"t1_phan1k9-post-rtjson-content\" class=\"py-0 xs:mx-xs mx-2xs max-w-full scalable-text [--emote-size:20px]\" dir=\"auto\">\n <p>\n …",
"content_type": "text",
"created_at": "2026-10-17T12:45:42.394000+0000",
"depth": 0,
"id": "t1_phan1k9",
"images": [],
"is_deleted": false,
"is_op": false,
"is_stickied": false,
"links": [],
"moderation_verdict": null,
"parent_id": null,
"parent_permalink": null,
"permalink": "/r/Python/comments/1x89bnq/comment/phan1k9/",
"position": 0,
"post_id": "t3_1x89bnq",
"score": "43",
"score_value": 43,
"url": "https://www.reddit.com/r/Python/comments/1x89bnq/comment/phan1k9/"
},
{
"attributes": {
"ariaLabel": "Comment thread level 1: Reply from One_Sun5074 6 days ago",
"author": "One_Sun5074",
"avatar": "https://styles.redditmedia.com/t5_c5znjd/styles/profileIcon_01we57gsd2uh1.jpeg?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=f…",
"class": "relative [contain:style] col-start-2",
"comment-parent-positions": "[0]",
"comment-position": "0",
"content-type": "text",
"created": "2026-10-17T17:44:10.863000+0000",
"depth": "1",
"highlight-variant": "",
"paid-award-only-comment-highlighting-enabled": true,
"parent-permalink": "/r/Python/comments/1x89bnq/comment/phan1k9/",
"parentId": "t1_phan1k9",
"permalink": "/r/Python/comments/1x89bnq/comment/phcdj14/",
"postId": "t3_1x89bnq",
"reload-url": "/svc/shreddit/comment/t1_phcdj14?depth=1&subredditName=Python",
"score": "5",
"slot": "children-t1_phan1k9-0",
"thingId": "t1_phcdj14"
},
"author": "One_Sun5074",
"author_avatar": "https://styles.redditmedia.com/t5_c5znjd/styles/profileIcon_01we57gsd2uh1.jpeg?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=f…",
"body": "Same here, 99% of what I touch in real-world projects is just base64 for API payloads and data URIs. That ~3.6x speedup on base64_large in 3…",
"body_html": "<div id=\"t1_phcdj14-post-rtjson-content\" class=\"py-0 xs:mx-xs mx-2xs max-w-full scalable-text [--emote-size:20px]\" dir=\"auto\">\n <p>\n …",
"content_type": "text",
"created_at": "2026-10-17T17:44:10.863000+0000",
"depth": 1,
"id": "t1_phcdj14",
"images": [],
"is_deleted": false,
"is_op": false,
"is_stickied": false,
"links": [],
"moderation_verdict": null,
"parent_id": "t1_phan1k9",
"parent_permalink": "/r/Python/comments/1x89bnq/comment/phan1k9/",
"permalink": "/r/Python/comments/1x89bnq/comment/phcdj14/",
"position": 0,
"post_id": "t3_1x89bnq",
"score": "5",
"score_value": 5,
"url": "https://www.reddit.com/r/Python/comments/1x89bnq/comment/phcdj14/"
},
"… 12 more"
],
"count": 14,
"credits_used": 1,
"more_comments_urls": [],
"post_id": "1x89bnq",
"post_permalink": "https://www.reddit.com/r/Python/comments/1x89bnq/python_310315_encoding_benchmarks_big_gains_for/",
"sort": "top",
"subreddit": "Python",
"total_comments": 16
} Response fields (55)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.comments | array |
$.comments[] | object | string |
$.comments[].attributes | object |
$.comments[].attributes.ariaLabel | string |
$.comments[].attributes.author | string |
$.comments[].attributes.avatar | string |
$.comments[].attributes.class | string |
$.comments[].attributes.comment-parent-positions | string |
$.comments[].attributes.comment-position | string |
$.comments[].attributes.content-type | string |
$.comments[].attributes.created | string |
$.comments[].attributes.depth | string |
$.comments[].attributes.highlight-variant | string |
$.comments[].attributes.paid-award-only-comment-highlighting-enabled | boolean |
$.comments[].attributes.parent-permalink | string |
$.comments[].attributes.parentId | string |
$.comments[].attributes.permalink | string |
$.comments[].attributes.postId | string |
$.comments[].attributes.record-ttci | boolean |
$.comments[].attributes.reload-url | string |
$.comments[].attributes.score | string |
$.comments[].attributes.slot | string |
$.comments[].attributes.thingId | string |
$.comments[].author | string |
$.comments[].author_avatar | string |
$.comments[].body | string |
$.comments[].body_html | string |
$.comments[].content_type | string |
$.comments[].created_at | string |
$.comments[].depth | integer |
$.comments[].id | string |
$.comments[].images | array |
$.comments[].is_deleted | boolean |
$.comments[].is_op | boolean |
$.comments[].is_stickied | boolean |
$.comments[].links | array |
$.comments[].moderation_verdict | null |
$.comments[].parent_id | null | string |
$.comments[].parent_permalink | null | string |
$.comments[].permalink | string |
$.comments[].position | integer |
$.comments[].post_id | string |
$.comments[].score | string |
$.comments[].score_value | integer |
$.comments[].url | string |
$.count | integer |
$.credits_used | integer |
$.more_comments_urls | array |
$.post_id | string |
$.post_permalink | string |
$.sort | string |
$.subreddit | string |
$.total_comments | integer |