Post Comments V2

Fetch post comments with automatic tree expansion. Supports sort, comment_mode (custom/top_level/all), and limit.

GET /api/v2/replies/by-post

Fetch post comments with automatic tree expansion. Supports sort, comment_mode (custom/top_level/all), and limit.

Query parameters

Name	Type	Required	Description
`post_id`	string	Yes	Post URL, t3_ID, or raw ID.
`sort`	string	No	Sort order: confidence, top, new, controversial, old, qa.
`comment_mode`	string	No	Comment mode: custom (limit N), top_level (no expansion), all (expand every hidden subtree).
`limit`	string	No	Max comments to fetch (for custom mode).

Authentication

Header	Value
`X-RapidAPI-Key`	Your RapidAPI key
`X-RapidAPI-Host`	`red-crawler1.p.rapidapi.com`

Example request

cURL

curl -X GET "https://red-crawler1.p.rapidapi.com/api/v2/replies/by-post?post_id=t3_1sys4r2&sort=hot&comment_mode=<comment_mode>&limit=25" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com"

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/replies/by-post?post_id=t3_1sys4r2&sort=hot&comment_mode=<comment_mode>&limit=25", {
  method: "GET",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/replies/by-post?post_id=t3_1sys4r2&sort=hot&comment_mode=<comment_mode>&limit=25"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.get(url, headers=headers)
print(resp.json())

Example response

HTTP 200 — captured from a live call to the gateway.

{
  "success": true,
  "data": {
    "post_id": "t3_1s916yh",
    "comments": [
      {
        "id": "t1_odkzeu4",
        "created_at": "2026-03-31T21:48:01.894000+0000",
        "edited_at": null,
        "score": 9419,
        "author": "ALazy_Cat",
        "author_id": "t2_7dy3ou9d",
        "body": "Day ruined, couldn't slap my sister",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odkzeu4/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      },
      {
        "id": "t1_odl3uc1",
        "created_at": "2026-03-31T22:10:16.968000+0000",
        "edited_at": "2026-03-31T22:38:44.422000+0000",
        "score": 3753,
        "author": "user-unknown-404",
        "author_id": "t2_eoac2yjn",
        "body": "Omg! I feel so sad for that kitty. Someone please slap the other one for her!",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odl3uc1/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      },
      {
        "id": "t1_odl210b",
        "created_at": "2026-03-31T22:00:58.311000+0000",
        "edited_at": null,
        "score": 3670,
        "author": "Winter_Strength_3920",
        "author_id": "t2_rrf0o4kj",
        "body": "I could still imagine the sound it makes \ud83e\ude77",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odl210b/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      },
      {
        "id": "t1_odl5yib",
        "created_at": "2026-03-31T22:21:17.972000+0000",
        "edited_at": null,
        "score": 2542,
        "author": "lostpurpose_7133",
        "author_id": "t2_9xepqsnke",
        "body": "In the end she sits down like, \"Eh, you know what you did.\"",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odl5yib/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      },
      {
        "id": "t1_odl69jq",
        "created_at": "2026-03-31T22:22:54.863000+0000",
        "edited_at": null,
        "score": 1089,
        "author": "TerrapinMagus",
        "author_id": "t2_tqeemtm",
        "body": "My brother's tripod tries to scratch himself with his missing hind leg, which is pathetic enough that it usually convinces one of us to get up and scratch the spot for him. So I guess it still works, only with lag.",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odl69jq/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      },
      {
        "id": "t1_odl45gr",
        "created_at": "2026-03-31T22:11:51.528000+0000",
        "edited_at": null,
        "score": 887,
        "author": "Mysterious_Status_11",
        "author_id": "t2_993zg92p",
        "body": "It's the thought that counts",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odl45gr/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      },
      {
        "id": "t1_odl5d87",
        "created_at": "2026-03-31T22:18:10.836000+0000",
        "edited_at": null,
        "score": 561,
        "author": "bookkinkster",
        "author_id": "t2_1bqgwjx9ai",
        "body": "Post this on the tripod subreddit! I have a tripod!",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odl5d87/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      },
      {
        "id": "t1_odl3rw5",
        "created_at": "2026-03-31T22:09:55.735000+0000",
        "edited_at": null,
        "score": 383,
        "author": "6thBornSOB",
        "author_id": "t2_16g9ay4r",
        "body": "\u201cIf I could Janet! If I could\u2026\u201d",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odl3rw5/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      },
      {
        "id": "t1_odl77hc",
        "created_at": "2026-03-31T22:27:54.217000+0000",
        "edited_at": null,
        "score": 234,
        "author": "Mauso88",
        "author_id": "t2_89a23lof",
        "body": "Ghost type attacks don\u2019t work against normal types",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odl77hc/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      },
      {
        "id": "t1_odl8qco",
        "created_at": "2026-03-31T22:36:11.730000+0000",
        "edited_at": null,
        "score": 204,
        "author": "GigachadKIVA",
        "author_id": "t2_141bl43z1m",
        "body": "And she still flinches \ud83d\ude02\ud83d\ude02",
        "permalink": "/r/cats/comments/1s916yh/if_only_i_had_two_front_paws_toonysworld/odl8qco/",
        "is_locked": false,
        "is_stickied": false,
        "is_score_hidden": false,
        "is_archived": false,
        "is_removed": false,
        "is_admin_takedown": false,
        "removed_by_category": null,
        "distinguished_as": null,
        "parent_id": null,
        "depth": 0
      }
    ],
    "count": 10,
    "post_comment_count": 487
  },
  "error": null,
  "timestamp": "2026-04-29T19:08:36.472581+00:00"
}