threadapiDocs
Reddit

Subreddit comments

listSubredditComments(sub, options?): Listing<Comment>

GET
https://api.threadapi.dev/v1/reddit/subreddit/comments
1 Credit

Lists a subreddit's comments, newest first, whatever post they're on. Each comment names its post, so you can open the thread with Post. 1 credit per page of up to 100 comments; see Listings and pages.

To be told about new comments that mention a keyword instead of polling, use Monitors.

API Key

All requests require a valid API key from the developer dashboard.

Headers: Authorization: Bearer YOUR_API_KEYorX-API-Key: YOUR_API_KEY

See Authentication for headers and rate limits.

Query parameters

ParameterTypeRequiredDescription
subquery
stringYes

Subreddit name, with or without r/.

limitquery
integerNo

Comments per page, 1 to 100. Default 25.

afterquery
stringNo

The previous page's after, for older comments.

nsfwquery
booleanNo

Include comments on NSFW posts. Default false.

Response

{
  "subreddit": "golang",
  "query": null,
  "sort": "new",
  "count": 3,
  "items": [
    {
      "id": "pf32lmh",
      "name": "t1_pf32lmh",
      "post_id": "1wxkbh0",
      "post_title": "Struggling to review and maintain an AI generated codebase growing too fast.",
      "subreddit": "golang",
      "author": "Inevitable-Cry-1389",
      "score": 1,
      "body": "another thing I uses everyday is to build the gate keeper in the CI…",
      "created_at": "2026-10-10T17:35:45Z",
      "permalink": "/r/golang/comments/1wxkbh0/struggling_to_review_and_maintain_an_ai_generated/pf32lmh/",
      "parent_id": "t1_pf31m12",
      "is_submitter": false,
      "controversiality": 0
    }
  ],
  "after": "t1_pf31mcc",
  "filtered_nsfw": 0
}

parent_id is the comment it replies to (t1_…), or the post (t3_…) for a top-level comment. is_submitter is true when the commenter wrote the post. controversiality is 1 when Reddit marks the comment controversial.