Reddit App Post Comments

API docs
https://api.sandbase.ai/v1/api/reddit/app/post-comments

Returns comment trees for a specific Reddit post by its ID. Supports comment sorting by hot, new, top, best, or controversial, with optional pagination via a cursor.

Price
$0.001USD / call
Method
POST
Response
JSON
Parameters
1 required · 3 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

Playground

Input
Post ID, format like "t3_XXXXXX"
Pagination parameter for fetching the next page, can be found in the last comment node in commentForest, e.g., $.data.postInfoById.commentForest.trees[-1].more.cursor
Whether to clean and format the data
Sort method, supports HOT, NEW, TOP, BEST, CONTROVERSIAL
OutputExample
Responseoutputs · 14.3 KB · 317 lines
[
  {
    "data": {
      "postInfoById": {
        "__typename": "SubredditPost",
        "commentCount": 1906,
        "commentForest": {
          "__typename": "CommentForest",
          "pageInfo": {
            "commentCount": 1819,
            "hasNextPage": true
          },
          "trees": [
            {
              "childCount": 0,
              "depth": 0,
              "more": null,
              "node": {
                "__typename": "Comment",
                "authorCommunityBadge": null,
                "authorFlair": null,
                "authorInfo": {
                  "__typename": "Redditor",
                  "accountType": "USER",
                  "iconSmall": {
                    "__typename": "MediaSource",
                    "dimensions": {
                      "height": 50,
                      "width": 50
                    },
                    "url": "https://styles.redditmedia.com/t5_1yz875/styles/profileIcon_klqlly9fc4l41.png?width=50&height=50&frame=1&auto=webp&crop=50%3A50%2Csmart&s=75d82dd0dc0f698f4c89f5b2b88dc2027d57c0fa"
                  },
                  "id": "t2_6l4z3",
                  "isBlocked": false,
                  "isCakeDayNow": false,
                  "isPremiumAvatarTreatment": true,
                  "name": "AutoModerator",
                  "newIcon": {
                    "__typename": "MediaSource",
                    "dimensions": {
                      "height": 256,
                      "width": 256
                    },
                    "url": "https://styles.redditmedia.com/t5_1yz875/styles/profileIcon_klqlly9fc4l41.png?frame=1&auto=webp&crop=256%3A256%2Csmart&s=2d8339b3c4c3cb974bc2ac8b46cd95db091a24d1"
                  },
                  "profile": {
                    "isNsfw": false
                  },
                  "snoovatarIcon": null
                },
                "commentStats": null,
                "content": {
                  "__typename": "Content",
                  "markdown": "It looks like this post is about Politics. Various methods of filtering out content relating to Politics can be found [here](https://www.reddit.com/r/pics/wiki/v2/resources/filter/politics).\n\n*I am a bot, and this action was performed automatically. Please [contact the moderators of this subreddit](/message/compose/?to=/r/pics) if you have any questions or concerns.*",
                  "preview": "It looks like this post is about Politics. Various methods of filtering out content relating to Politics can be found here. I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.",
                  "richtext": "{\"document\":[{\"c\":[{\"e\":\"text\",\"t\":\"It looks like this post is about Politics. Various methods of filtering out content relating to Politics can be found \"},{\"e\":\"link\",\"t\":\"here\",\"u\":\"https://www.reddit.com/r/pics/wiki/v2/resources/filter/politics\"},{\"e\":\"text\",\"t\":\".\"}],\"e\":\"par\"},{\"c\":[{\"e\":\"text\",\"f\":[[2,0,64]],\"t\":\"I am a bot, and this action was performed automatically. Please \"},{\"e\":\"link\",\"f\":[[2,0,40]],\"t\":\"contact the moderators of this subreddit\",\"u\":\"/message/compose/?to=/r/pics\"},{\"e\":\"text\",\"f\":[[2,0,39]],\"t\":\" if you have any questions or concerns.\"}],\"e\":\"par\"}]}",
                  "richtextMedia": [],
                  "translationInfo": {
                    "isTranslated": false,
                    "translatedLanguage": null
                  },
                  "typeHint": "TEXT"
                },
                "createdAt": "2025-10-30T02:17:24.998000+0000",
                "distinguishedAs": "MODERATOR",
                "editedAt": null,
                "id": "t1_nm4g5sx",
                "initiallyCollapsedReason": "STICKY_AUTOMOD",
                "isAdminTakedown": false,
                "isArchived": true,
                "isCommercialCommunication": false,
                "isGildable": true,
                "isInitiallyCollapsed": true,
                "isLocked": false,
                "isRemoved": false,
                "isSaved": false,
                "isScoreHidden": true,
                "isStickied": true,
                "isTranslatable": true,
                "languageCode": "en",
                "modContentDiscussion": null,
                "moderationInfo": null,
                "permalink": "/r/pics/comments/1ojnvca/official_photo_of_trumpxi_meeting_in_busan_south/nm4g5sx/",
                "removedByCategory": null,
                "score": 1,
                "voteState": "NONE"
              },
              "parentId": null
            },
            {
              "childCount": 11,
              "depth": 0,
              "more": null,
              "node": {
                "__typename": "Comment",
                "authorCommunityBadge": null,
                "authorFlair": null,
                "authorInfo": {
                  "__typename": "Redditor",
                  "accountType": "USER",
                  "iconSmall": {
                    "__typename": "MediaSource",
                    "dimensions": {
                      "height": 50,
                      "width": 50
                    },
                    "url": "https://preview.redd.it/snoovatar/avatars/bba140a1-10e6-4ac5-9ab3-51503d3527d2-headshot.png?width=50&height=50&auto=webp&s=c72fcb1dbd61209983461bee73e29b101cee84aa"
                  },
                  "id": "t2_1m3v2g9pqs",
                  "isBlocked": false,
                  "isCakeDayNow": false,
                  "isPremiumAvatarTreatment": false,
                  "name": "eddietheeddie",
                  "newIcon": {
                    "__typename": "MediaSource",
                    "dimensions": {
                      "height": 256,
                      "width": 256
                    },
                    "url": "https://preview.redd.it/snoovatar/avatars/bba140a1-10e6-4ac5-9ab3-51503d3527d2-headshot.png?auto=webp&s=25d7ce6eecdbb87b0853fb8fe14d6d6c3a4df9f5"
                  },
                  "profile": {
                    "isNsfw": false
                  },
                  "snoovatarIcon": {
                    "__typename": "MediaSource",
                    "dimensions": {
                      "height": 600,
                      "width": 380
                    },
                    "url": "https://i.redd.it/snoovatar/avatars/bba140a1-10e6-4ac5-9ab3-51503d3527d2.png"
                  }
                },
                "commentStats": null,
                "content": {
                  "__typename": "Content",
                  "markdown": "This bitch is melting",
                  "preview": "This bitch is melting",
                  "richtext": "{\"document\":[{\"c\":[{\"e\":\"text\",\"t\":\"This bitch is melting\"}],\"e\":\"par\"}]}",
                  "richtextMedia": [],
                  "translationInfo": {
                    "isTranslated": false,
                    "translatedLanguage": null
                  },
                  "typeHint": "TEXT"
                },
                "createdAt": "2025-10-30T02:37:01.531000+0000",
                "distinguishedAs": null,
                "editedAt": null,
                "id": "t1_nm4jkk6",
                "initiallyCollapsedReason": null,
                "isAdminTakedown": false,
                "isArchived": true,
                "isCommercialCommunication": false,
                "isGildable": true,
                "isInitiallyCollapsed": false,
                "isLocked": false,
                "isRemoved": false,
                "isSaved": false,
                "isScoreHidden": false,
                "isStickied": false,
                "isTranslatable": true,
                "languageCode": "en",
                "modContentDiscussion": null,
                "moderationInfo": null,
                "permalink": "/r/pics/comments/1ojnvca/official_photo_of_trumpxi_meeting_in_busan_south/nm4jkk6/",
                "removedByCategory": null,
                "score": 4698,
                "voteState": "NONE"
              },
              "parentId": null
            },
            {
              "childCount": 2,
              "depth": 1,
              "more": null,
              "node": {
                "__typename": "Comment",
                "authorCommunityBadge": null,
                "authorFlair": null,
                "authorInfo": {
                  "__typename": "Redditor",
                  "accountType": "USER",
                  "iconSmall": {
                    "__typename": "MediaSource",
                    "dimensions": {
                      "height": 50,
                      "width": 50
                    },
                    "url": "https://styles.redditmedia.com/t5_bs271/styles/profileIcon_snooec0133dd-3f43-4d38-8006-402176562809-headshot-f.png?width=50&height=50&frame=1&auto=webp&crop=50%3A50%2Csmart&s=500dde32eab9c5f6142e0fb0c0a15f5ade86a27c"
                  },
                  "id": "t2_z1uiu",
                  "isBlocked": false,
                  "isCakeDayNow": false,
                  "isPremiumAvatarTreatment": false,
                  "name": "SpeedBlitzX",
                  "newIcon": {
                    "__typename": "MediaSource",
                    "dimensions": {
                      "height": 256,
                      "width": 256
                    },
                    "url": "https://styles.redditmedia.com/t5_bs271/styles/profileIcon_snooec0133dd-3f43-4d38-8006-402176562809-headshot-f.png?frame=1&auto=webp&crop=256%3A256%2Csmart&s=9b25cc2f16da18c3461436f813be7ff330f6e9d9"
                  },
                  "profile": {
                    "isNsfw": false
                  },
                  "snoovatarIcon": {
                    "__typename": "MediaSource",
                    "dimensions": {
                      "height": 600,
                      "width": 380
                    },
                    "url": "https://i.redd.it/snoovatar/avatars/ec0133dd-3f43-4d38-8006-402176562809.png"
                  }
                },
                "commentStats": null,
                "content": {
                  "__typename": "Content",
                  "markdown": "![gif](giphy|GCkHxV0XSKjf2)\n\nHoly Shrimp over 195k people saw this gif/comment????",
                  "preview": "Holy Shrimp over 195k people saw this gif/comment????",
                  "richtext": "{\"document\":[{\"c\":[{\"e\":\"gif\",\"id\":\"giphy|GCkHxV0XSKjf2\"}],\"e\":\"par\"},{\"c\":[{\"e\":\"text\",\"t\":\"Holy Shrimp over 195k people saw this gif/comment????\"}],\"e\":\"par\"}]}",
                  "richtextMedia": [
                    {
                      "__typename": "ImageAsset",
                      "height": 200,
                      "id": "giphy|GCkHxV0XSKjf2",
                      "large": null,
                      "medium": {
                        "__typename": "MediaSource",
                        "dimensions": {
                          "height": 162,
                          "width": 216
                        },
                        "url": "https://external-preview.redd.it/1fRn1DPbNnOwcehc-7mq9oaWrAznVgLKbIwFJKjz_W8.gif?width=216&auto=webp&s=6f29b3d4e5ec0ffc53f514215687da5d81d9ecd2"
                      },
                      "mimetype": "image/gif",
                      "obfuscated_large": null,
                      "obfuscated_medium": null,
                      "obfuscated_small": null,
                      "obfuscated_xlarge": null,
                      "obfuscated_xxlarge": null,
                      "obfuscated_xxxlarge": null,
                      "small": {
                        "__typename": "MediaSource",
                        "dimensions": {
                          "height": 81,
                          "width": 108
                        },
                        "url": "https://external-preview.redd.it/1fRn1DPbNnOwcehc-7mq9oaWrAznVgLKbIwFJKjz_W8.gif?width=108&auto=webp&s=5ad5c105acfdf675b80a342b3f0849761acf7531"
                      },
                      "status": "VALID",
                      "url": "https://external-preview.redd.it/1fRn1DPbNnOwcehc-7mq9oaWrAznVgLKbIwFJKjz_W8.gif?auto=webp&s=07bce103588c17b8b752ac33753d4d0238e43e3f",
                      "userId": null,
                      "width": 266,
                      "xlarge": null,
                      "xxlarge": null,
                      "xxxlarge": null
                    }
                  ],
                  "translationInfo": {
                    "isTranslated": false,
                    "translatedLanguage": null
                  },
                  "typeHint": "RTJSON"
                },
                "createdAt": "2025-10-30T03:46:42.342000+0000",
                "distinguishedAs": null,
                "editedAt": "2025-10-31T04:59:45.702000+0000",
                "id": "t1_nm4ugib",
                "initiallyCollapsedReason": null,
                "isAdminTakedown": false,
                "isArchived": true,
                "isCommercialCommunication": false,
                "isGildable": true,
                "isInitiallyCollapsed": false,
                "isLocked": false,
                "isRemoved": false,
                "isSaved": false,
                "isScoreHidden": false,
                "isStickied": false,
                "isTranslatable": true,
                "languageCode": "en",
                "modContentDiscussion": null,
                "moderationInfo": null,
                "permalink": "/r/pics/comments/1ojnvca/official_photo_of_trumpxi_meeting_in_busan_south/nm4ugib/",
                "removedByCategory": null,
                "score": 916,
                "voteState": "NONE"
              },
              "parentId": "t1_nm4jkk6"
            },
            "… 10 more items in the full response"
          ]
        },
        "id": "t3_1ojnvca",
        "subreddit": {
          "allowedMediaInComments": [
            "GIPHY",
            "STATIC",

Examples

Select an example to load its inputs and result into the playground.

API README

Reddit App Post Comments API

Returns the comment tree for one Reddit post, including each comment's author, text, timestamp, depth and reply count. It needs a post_id in the form t3_XXXXXX. You can choose the comment sort order and page through the results.

Use cases

  • Collect the top comments under a popular post to study how a community reacts to a news event.
  • Pull the newest comments with sort_type set to NEW to monitor a live thread.
  • Build a dataset of comment text and author names for sentiment analysis on one post.
  • Check which comments come from moderators or bots using the distinguishedAs field.

Request

curl -X POST "https://api.sandbase.ai/v1/api/reddit/app/post-comments" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_id": "t3_1ojnvca"}'

The result is returned in outputs[0].data.

Parameters

NameTypeRequiredDescription
post_idstringYesPost ID, format like "t3_XXXXXX"
afterstringNoPagination parameter for fetching the next page, can be found in the last comment node in commentForest, e.g., $.data.postInfoById.commentForest.trees[-1].more.cursor
need_formatbooleanNoWhether to clean and format the data
sort_typestringNoSort method, supports HOT, NEW, TOP, BEST, CONTROVERSIAL

Example response

Real response for the request above, trimmed: lists keep their first item and long strings are cut.

{
  "postInfoById": {
    "__typename": "SubredditPost",
    "commentCount": 1905,
    "commentForest": {
      "__typename": "CommentForest",
      "pageInfo": {
        "commentCount": 1802,
        "hasNextPage": true
      },
      "trees": [
        {
          "childCount": 0,
          "depth": 0,
          "more": null,
          "node": {
            "__typename": "Comment",
            "authorCommunityBadge": null,
            "authorFlair": null,
            "authorInfo": {
              "__typename": "Redditor",
              "accountType": "USER",
              "iconSmall": {
                "__typename": "MediaSource",
                "dimensions": {
                  "height": 50,
                  "width": 50
                },
                "url": "https://styles.redditmedia.com/t5_1yz875/styles/profileIcon_klqlly9fc4l41.png?wi…"
              },
              "id": "t2_6l4z3",
              "isBlocked": false,
              "isCakeDayNow": false,
              "isPremiumAvatarTreatment": true,
              "name": "AutoModerator"
            },
            "commentStats": null,
            "content": {
              "__typename": "Content",
              "markdown": "It looks like this post is about Politics. Various methods of filtering out cont…",
              "preview": "It looks like this post is about Politics. Various methods of filtering out cont…",
              "richtext": "{\"document\":[{\"c\":[{\"e\":\"text\",\"t\":\"It looks like this post is about Politics. V…",
              "richtextMedia": [],
              "translationInfo": {
                "isTranslated": false,
                "translatedLanguage": null
              },
              "typeHint": "TEXT"
            },
            "createdAt": "2025-10-30T02:17:24.998000+0000",
            "distinguishedAs": "MODERATOR"
          },
          "parentId": null
        }
      ]
    },
    "id": "t3_1ojnvca",
    "subreddit": {
      "allowedMediaInComments": [
        "GIPHY"
      ],
      "id": "t5_2qh0u",
      "isQuarantined": false,
      "moderation": {
        "isShowCommentRemovalReasonPrompt": true
      },
      "name": "pics",
      "prefixedName": "r/pics",
      "tippingStatus": null
    },
    "title": "Official photo of Trump-Xi meeting in Busan, South Korea"
  }
}

Response fields

FieldMeaning
postInfoById.titleTitle of the post the comments belong to.
postInfoById.commentCountTotal comment count for the post.
postInfoById.commentForest.pageInfo.hasNextPagetrue when more comments can be fetched with another page request.
postInfoById.commentForest.pageInfo.commentCountComment count reported for the forest in this response.
postInfoById.commentForest.trees[].depthNesting level of the comment. 0 is a top-level comment, 1 is a reply to it, and so on.
postInfoById.commentForest.trees[].childCountNumber of replies under this comment.
postInfoById.commentForest.trees[].parentIdID of the parent comment, such as t1_nm4jkk6. It is null for top-level comments.
postInfoById.commentForest.trees[].node.authorInfo.name / postInfoById.commentForest.trees[].node.authorInfo.idUsername and user ID (format t2_...) of the comment author.
postInfoById.commentForest.trees[].node.content.markdown / postInfoById.commentForest.trees[].node.content.previewComment text as Markdown and as a short plain-text preview.
postInfoById.commentForest.trees[].node.createdAt / postInfoById.commentForest.trees[].node.distinguishedAsISO 8601 creation time of the comment, and a label such as MODERATOR when the comment is distinguished. The label is null otherwise.

Notes

  • Pass post_id with the t3_ prefix, for example t3_1ojnvca.
  • sort_type accepts HOT, NEW, TOP, BEST and CONTROVERSIAL. The default is CONFIDENCE.
  • When hasNextPage is true, take the cursor from the last item in commentForest.trees[] (its more.cursor value) and send it as after.
  • To load the replies under a single comment, call Reddit App Comment Replies. For the post itself, use Reddit Post Details.

Pricing

$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Explore more

Related APIs

All APIs
APIPriceResponse
Reddit$0.001 per callJSON
Reddit$0.001 per callJSON
Reddit$0.001 per callJSON
Reddit$0.001 per callJSON
Reddit$0.001 per callJSON
Reddit$0.001 per callJSON

Questions

FAQ

How do I use the Reddit App Post Comments API?

Send a POST request to https://api.sandbase.ai/v1/api/reddit/app/post-comments with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Reddit App Post Comments API cost?

$0.001 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Reddit App Post Comments API accept?

Required: post_id (string). Optional: after (string), need_format (boolean) and sort_type (string). The Parameters table and the Playground on this page list every field.

What does the Reddit App Post Comments API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Reddit developer account or API key?

No. Reddit App Post Comments runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Reddit API access separately.