# Reddit User Comments API

> List a Reddit user's comments by username, sorted by new, top, hot, or controversial, with the parent post title and subreddit on every item and cursor pagination. Comment text may be truncated to a roughly 300-character preview, and this endpoint carries no per-comment permalink; use reddit.post_comments for full comment bodies and comment URLs on a given post.

Source: https://www.sandbase.ai/apis/reddit/user-comments
API reference: https://www.sandbase.ai/apis/reddit/user-comments/docs

## Facts

- Provider: Reddit
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/reddit/user-comments`
- Price: From $0.0006 per call
- Capabilities: api, reddit, social media
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/reddit/user-comments` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `username` | string | yes |  |
| `sort` | string | no | new, top, hot, controversial |
| `limit` | integer | no |  |
| `cursor` | string | no |  |

## FAQ

### How do I use the Reddit User Comments API?

Send a POST request to https://api.sandbase.ai/v1/api/reddit/user-comments with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Reddit User Comments API cost?

From $0.0006 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Reddit User Comments API accept?

Required: username (string). Optional: sort (one of new, top, hot, controversial), limit (integer) and cursor (string). The Parameters table and the Playground on this page list every field.

### What does the Reddit User Comments API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Reddit developer account or API key?

No. Reddit User Comments runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Reddit API access separately.

## README

### Reddit User Comments API

List a Reddit user's comments by username, sorted by new, top, hot, or controversial, with the parent post title and subreddit on every item and cursor pagination. Comment text may be truncated to a roughly 300-character preview, and this endpoint carries no per-comment permalink; use reddit.post_comments for full comment bodies and comment URLs on a given post.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/reddit/user-comments" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "spez"}'
```

The result is returned in `outputs[0].data`. A lookup that finds nothing still succeeds and returns `found: false`.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `username` | string | Yes | Reddit username, without the u/ prefix. Example: "spez". |
| `cursor` | string | No | Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it back to fetch the next page. |
| `limit` | integer | No | Page size to ask for (up to 100, default 25). Some sources honor it; others always return their whole page of about 25 comments. A page is never trimmed after the call, so pass nextCursor back as cursor to continue exact |
| `sort` | string | No | Sort order for the user's comments. Defaults to new (most recent first). One of: `new`, `top`, `hot`, `controversial`. |

#### Pricing

Billed at the actual cost of each call, usually $0.0006 per request. A call can cost more when the first data source fails and another one answers. Failed calls are not charged. Lookups that find nothing and searches with no results are billed at their actual cost, which is often lower and can be $0.