# User comments



<MethodPage method="GET" path="/v1/reddit/user/comments" credits={1}>
  <MethodSignature name="listUserComments" args={[{ name: "name" }, { name: "options", optional: true }]} returns="Listing<Comment>" />

  Lists a user's comments, newest first by default. Comments come back as in [Subreddit comments](/reddit/subreddit-comments). 1 credit per page of up to 100 comments; see [Listings and pages](/listings).

  <Security permission="reddit:read" />

  <SchemaGroup title="Query parameters">
    <SchemaField name="name" type="string" location="query" required>
      Reddit username, with or without `u/`.
    </SchemaField>

    <SchemaField name="sort" type="string" optional location="query">
      `new` (default), `hot`, `top` or `controversial`.
    </SchemaField>

    <SchemaField name="t" type="string" optional location="query">
      Time window for `top` and `controversial`: `hour`, `day`, `week`, `month`, `year` or `all`.
    </SchemaField>

    <SchemaField name="limit" type="integer" optional location="query">
      Comments per page, 1 to 100. Default `25`.
    </SchemaField>

    <SchemaField name="after" type="string" optional location="query">
      The previous page's `after`, for the next page.
    </SchemaField>

    <SchemaField name="nsfw" type="boolean" optional location="query">
      Include comments on NSFW posts. Default `false`.
    </SchemaField>
  </SchemaGroup>

  <div id="returns" className="mt-8">
    Response [#response]

    ```jsonc
    {
      "subreddit": null,
      "query": null,
      "sort": "new",
      "count": 3,
      "items": [
        {
          "id": "p1wosm9",
          "name": "t1_p1wosm9",
          "post_id": "1vgbkge",
          "post_title": "Modernizing Reddit’s infrastructure with you",
          "subreddit": "u_spez",
          "author": "spez",
          "score": 15,
          "body": "That was the thinking. Otherwise it would be easier to just replicate the UI. ",
          "created_at": "2026-08-05T18:31:50Z",
          "permalink": "/r/u_spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/p1wosm9/",
          "parent_id": "t1_p1wd2fi",
          "is_submitter": true,
          "controversiality": 0
        }
      ],
      "after": "t1_p1w9j2v",
      "filtered_nsfw": 0
    }
    ```

    A user who doesn't exist returns 404 `not_found`.
  </div>

  <MethodSamples>
    <LanguageSample language="cURL">
      ```bash
      curl "https://api.threadapi.dev/v1/reddit/user/comments?name=spez&sort=top&t=year&limit=50" \
        -H "Authorization: Bearer $THREADAPI_API_KEY"
      ```
    </LanguageSample>
  </MethodSamples>
</MethodPage>