---
title: "List Reddit subreddit comments"
method: GET
path: "/reddit/subreddit/{subreddit}/comments"
tags: ["Reddit"]
---

# List Reddit subreddit comments

`GET /reddit/subreddit/{subreddit}/comments`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/reddit/subreddit/{subreddit}/comments`
- Auth: API key in header `x-api-key`

Returns flat public comment entries from a subreddit latest-comments feed. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.

## Path parameters

- `subreddit` string, required

## Query parameters

- `limit` integer
- `after` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RedditSubredditCommentsResponseDoc
  - `code` integer
  - `data` RedditSubredditCommentsResponse
    - `comments` RedditComment[]: Recent comments in the subreddit.
      - `author` RedditAuthor
        - `name` string: Reddit username of the author.
        - `profile_url` string: URL of the author's Reddit profile page.
      - `award_count` integer: Number of awards the comment received. Set only when metrics are requested.
      - `body` string: Text of the comment as written by the author.
      - `created` string: Time the comment was posted, in UTC (RFC 3339).
      - `created_utc` integer: Time the comment was posted, in Unix seconds.
      - `depth` integer: Nesting level of the comment in the thread.
      - `id` string: Reddit comment id.
      - `name` string: Reddit full name of the comment, the id prefixed with `t1_`.
      - `parent_id` string: Full name of the post or comment this comment replies to, for example `t3_1abcxyz`.
      - `permalink` string: Reddit URL of the comment.
      - `replies` RedditComment[]: Replies to this comment, in the same shape.
      - `score` integer: Net score of the comment. Set only when metrics are requested.
    - `pagination` RedditPagination
      - `after` string: Cursor to pass as the `after` parameter to fetch the next page.
      - `limit` integer: Maximum number of items requested for this page.
    - `source` RedditSourceDetail
      - `type` string: Kind of Reddit source the data was read from.
      - `url` string: Reddit URL the data was read from.
    - `subreddit` string: Subreddit name, without `r/`.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)
