Search APIs
Loading…
← API Store
Social

Reddit

Reddit

Comments of a Reddit post

GET /reddit/v1/comments
Test this endpoint

The 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

NameTypeDescription
urlstringPost URL (instead of subreddit + post_id). Example: https://www.reddit.com/r/Python/comments/1x89bnq/
subredditstring Example: Python
post_idstring Example: 1x89bnq
sortbest | confidence | top | new | controversial | old | qaComment sort: best (confidence), top (default), new, controversial, old, qa. Example: top
post_urlstringSame as `url`.
tree0 | 11 adds `comment_tree`: the same comments nested, each with its `replies` and folded `more_replies`.
cursorstring`next_cursor` from the previous page (more top-level comments), or a `more_replies[].cursor` (the replies Reddit folded under that comment).
depthintegerDeepest 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
$.cachedboolean
$.commentsarray
$.comments[]object | string
$.comments[].attributesobject
$.comments[].attributes.ariaLabelstring
$.comments[].attributes.authorstring
$.comments[].attributes.avatarstring
$.comments[].attributes.classstring
$.comments[].attributes.comment-parent-positionsstring
$.comments[].attributes.comment-positionstring
$.comments[].attributes.content-typestring
$.comments[].attributes.createdstring
$.comments[].attributes.depthstring
$.comments[].attributes.highlight-variantstring
$.comments[].attributes.paid-award-only-comment-highlighting-enabledboolean
$.comments[].attributes.parent-permalinkstring
$.comments[].attributes.parentIdstring
$.comments[].attributes.permalinkstring
$.comments[].attributes.postIdstring
$.comments[].attributes.record-ttciboolean
$.comments[].attributes.reload-urlstring
$.comments[].attributes.scorestring
$.comments[].attributes.slotstring
$.comments[].attributes.thingIdstring
$.comments[].authorstring
$.comments[].author_avatarstring
$.comments[].bodystring
$.comments[].body_htmlstring
$.comments[].content_typestring
$.comments[].created_atstring
$.comments[].depthinteger
$.comments[].idstring
$.comments[].imagesarray
$.comments[].is_deletedboolean
$.comments[].is_opboolean
$.comments[].is_stickiedboolean
$.comments[].linksarray
$.comments[].moderation_verdictnull
$.comments[].parent_idnull | string
$.comments[].parent_permalinknull | string
$.comments[].permalinkstring
$.comments[].positioninteger
$.comments[].post_idstring
$.comments[].scorestring
$.comments[].score_valueinteger
$.comments[].urlstring
$.countinteger
$.credits_usedinteger
$.more_comments_urlsarray
$.post_idstring
$.post_permalinkstring
$.sortstring
$.subredditstring
$.total_commentsinteger