---
title: "List the comments an account has made"
method: GET
path: "/v1/reddit/users/{username}/comments"
tags: ["Reddit"]
---

# List the comments an account has made

`GET /v1/reddit/users/{username}/comments`

## Request

- Base URL: `https://api.weirapp.io`
- URL: `https://api.weirapp.io/v1/reddit/users/{username}/comments`
- Auth: HTTP bearer

Comments the account made, across every community, each with the post it belongs to
(`linkTitle`, `linkPermalink`). Newest first by default.

Reddit lets people hide some or all of their activity from their profile, so an empty page
for an account with karma usually means hidden, not inactive. An account that does not exist
is a 404, and a suspended one is a 404 with `details.reason` `suspended`. Pages stop at
about 1,000 items, Reddit's own ceiling.

## Path parameters

- `username` string, required: Username without the `u/` prefix.

## Query parameters

- `sort` 'new' | 'hot' | 'top' | 'controversial': `new` is what the account did most recently.
- `time` 'hour' | 'day' | 'week' | 'month' | 'year' | 'all': Window for `top` and `controversial` only. Defaults to `all` for those sorts.
- `includeNsfw` 'true' | 'false': Include posts marked NSFW. Off by default; what it removes is reported in `meta.omittedNsfw`, so a short or empty page is never mistaken for a quiet one.
- `limit` integer
- `cursor` string: `meta.nextCursor` from the previous page, unchanged. Opaque, signed, and bound to the other parameters: change any of them and start again without a cursor.

## Response `200`

Comments, in Reddit's own field names.

- object
  - `data` object[], required
    - `id` string, required: Reddit's base-36 comment id, without the `t1_` prefix.
    - `postId` string, required: The post this comment belongs to, without `t3_`.
    - `parentId` string, required: The comment or post this replies to.
    - `author` string, required: Username without the `u/` prefix. `[deleted]` if removed.
    - `body` string, required: Markdown. `[removed]` or `[deleted]` once taken down.
    - `score` integer, required
    - `permalink` string, required: Absolute URL of the comment.
    - `createdUtc` number, required
    - `createdAt` string, date-time, required
    - `subreddit` string, required: Community name without the `r/` prefix.
    - `isSubmitter` boolean, required: The commenter is the post's author (OP).
    - `edited` number, nullable, required: When the comment was last edited, in epoch seconds. Null if it never was.
    - `distinguished` string, nullable, required: `moderator` or `admin` when posted in an official capacity; otherwise null.
    - `stickied` boolean, required: Pinned under the post by a moderator.
    - `scoreHidden` boolean, required: Reddit is hiding this comment's score for now; `score` means nothing while true.
    - `linkTitle` string, required: Title of the post the comment belongs to.
    - `linkAuthor` string, required: Author of that post.
    - `linkPermalink` string, required: Absolute URL of that post.
    - `numComments` integer, required: Comments on that post.
    - `over18` boolean, required: That post is marked NSFW.
  - `meta` object, required
    - `requestId` string, required
    - `nextCursor` string, nullable
    - `omittedNsfw` integer: Items removed from this page because they are marked NSFW and `includeNsfw` is false. Absent when nothing was removed. A page can be short, or even empty with a non-null `nextCursor`, because of it.

## Other responses

- `400`: The request failed validation.
- `401`: The API key is missing, malformed, expired, or revoked.
- `402`: The account is out of credit. Not retryable: this cannot clear until the billing period resets or the plan changes.
- `403`: The API key does not carry the scope this route requires.
- `404`: The requested resource does not exist.
- `429`: The per-minute rate limit is exhausted. Retryable: wait for Retry-After and try again.
- `500`: An unexpected error occurred.
- `503`: The source is temporarily unavailable. The request is safe to retry.

---

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