---
title: "Get Reddit post comments"
method: GET
path: "/reddit/comments/{id}"
tags: ["Reddit"]
---

# Get Reddit post comments

`GET /reddit/comments/{id}`

## Request

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

Returns a Reddit post with its public comments. The default mode is 1 credit. Set `include_metrics=true` to return the comments with public net score and award count plus post engagement metrics for 3 credits. Large threads may expose only an initial comment subset. Reddit does not expose per-comment upvote ratios or exact upvote/downvote totals anonymously. A post that exists but has no comments yet returns a 200 response with an empty comments list; a post that does not exist returns 404, and a temporary block or upstream failure returns 503 (retryable) rather than 404. If source.type is redlib, public fields and credit weights are preserved.

## Path parameters

- `id` string, required

## Query parameters

- `sort` 'confidence' | 'top' | 'new' | 'controversial' | 'old' | 'qa'
- `limit` integer
- `depth` integer
- `include_metrics` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RedditCommentsResponseDoc
  - `code` integer
  - `data` RedditCommentsResponse
    - `comments` RedditComment[]: Comments on the post.
      - `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.
    - `metrics_source` RedditSourceDetail
      - `type` string: Kind of Reddit source the data was read from.
      - `url` string: Reddit URL the data was read from.
    - `post` RedditPost
      - `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 post received. Set only when metrics are requested.
      - `comment_count` integer: Number of comments on the post. Set only when metrics are requested.
      - `created` string: Time the post was submitted, in UTC (RFC 3339).
      - `created_utc` integer: Time the post was submitted, in Unix seconds.
      - `domain` string: Domain of the linked content, or `self.<subreddit>` for text posts.
      - `estimated_downvotes` integer: Approximate downvote total worked out from the score and upvote ratio. Reddit does not publish exact counts.
      - `estimated_upvotes` integer: Approximate upvote total worked out from the score and upvote ratio. Reddit does not publish exact counts.
      - `flair` string: Flair text attached to the post.
      - `id` string: Reddit post id.
      - `is_self` boolean: Whether the post is a text post rather than a link.
      - `is_video` boolean: Whether the post is a video.
      - `locked` boolean: Whether the post is locked against new comments.
      - `name` string: Reddit full name of the post, the id prefixed with `t3_`.
      - `over_18` boolean: Whether the post is marked as 18+ content.
      - `permalink` string: Reddit URL of the post's comments page.
      - `score` integer: Net score of the post, upvotes minus downvotes as Reddit shows it. Set only when metrics are requested.
      - `selftext` string: Body text of a text post.
      - `source_feed_url` string: URL of the Reddit feed the post was read from.
      - `stickied` boolean: Whether the post is pinned to the top of its subreddit.
      - `subreddit` string: Name of the subreddit the post belongs to, without `r/`.
      - `thumbnail` string: URL of the post thumbnail image.
      - `title` string: Title of the post as submitted.
      - `upvote_ratio` number: Share of votes that are upvotes, from 0 to 1. Set only when metrics are requested.
      - `url` string: Reddit URL of the post.
      - `vote_counts_estimated` boolean: Whether `estimated_upvotes` and `estimated_downvotes` are estimates.
    - `source` RedditSourceDetail
      - `type` string: Kind of Reddit source the data was read from.
      - `url` string: Reddit URL the data was read from.
  - `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/0497899e2016?raw)