# List the posts an account has submitted

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

Posts the account submitted, across every community, newest first by default. To be told
when it posts, create a `reddit_user` monitor instead of polling.

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.

**Price:** 1 credit per call, plus 3 credits per Reddit post returned. Failed and refused calls cost nothing.

**Rate limit:** Counts as 2 requests against your per-minute rate limit.

**MCP tool:** `get_reddit_user_posts`, on every [MCP](/mcp) connection.

Requires an API key, sent as `Authorization: Bearer <key>`.

## Request

```bash
curl --request GET \
  --url https://api.weirapp.io/v1/reddit/users/USERNAME/posts \
  --header "Authorization: Bearer $WEIR_API_KEY"
```

### Path parameters

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `username` | string | yes | Username without the `u/` prefix. · matches `^[A-Za-z0-9_-]{1,20}$` |

### Query parameters

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `sort` | string | no | `new` is what the account did most recently. · `new`, `hot`, `top`, `controversial`, default `"new"` |
| `time` | string | no | Window for `top` and `controversial` only. Defaults to `all` for those sorts. · `hour`, `day`, `week`, `month`, `year`, `all` |
| `includeNsfw` | string | no | 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. · `true`, `false`, default `"false"` |
| `limit` | integer | no | 1–100, default `25` |
| `cursor` | string | no | `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. · 1–4096 chars |

## Response

Posts, in Reddit's own field names.

### `200`

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data` | array of object | yes |  |
| `data[].id` | string | yes | Reddit's base-36 post id, without the `t3_` prefix. |
| `data[].subreddit` | string | yes | Community name without the `r/` prefix. |
| `data[].title` | string | yes |  |
| `data[].selftext` | string | yes | Body text. Empty for a link post. |
| `data[].author` | string | yes | Username without the `u/` prefix. `[deleted]` if removed. |
| `data[].permalink` | string | yes | Path on reddit.com, beginning with a slash. |
| `data[].url` | string | yes | Absolute URL to the post. |
| `data[].score` | integer | yes | Upvotes minus downvotes. Can be negative, and is fuzzed by Reddit. |
| `data[].upvoteRatio` | number | yes | Fraction of votes that were upvotes. · 0–1 |
| `data[].numComments` | integer | yes | min 0 |
| `data[].over18` | boolean | yes | Marked NSFW by the author or a moderator. |
| `data[].createdUtc` | number | yes | Creation time in epoch seconds, as Reddit reports it. |
| `data[].createdAt` | string (date-time) | yes | The same instant as `createdUtc`, in ISO 8601. |
| `data[].domain` | string | yes | `self.<subreddit>` for a text post; otherwise the host the post links to. |
| `data[].isSelf` | boolean | yes | A text post rather than a link. |
| `data[].urlOverriddenByDest` | string or null | yes | Where a link post points. Null for a text post. |
| `data[].linkFlairText` | string or null | yes | The post's flair, such as `Question` or `Hiring`. Null when it has none. |
| `data[].authorFlairText` | string or null | yes | The author's flair in this community. |
| `data[].distinguished` | string or null | yes | `moderator` or `admin` when posted in an official capacity; otherwise null. |
| `data[].stickied` | boolean | yes | Pinned to the top of the community. |
| `data[].locked` | boolean | yes | New comments are disabled. |
| `data[].archived` | boolean | yes | Past Reddit's archive age: no new comments or votes. |
| `data[].spoiler` | boolean | yes |  |
| `data[].edited` | number or null | yes | When the post was last edited, in epoch seconds. Null if it never was. |
| `data[].numCrossposts` | integer | yes | min 0 |
| `data[].crosspostParent` | string or null | yes | The original post's id, without `t3_`, when this post is a crosspost. |
| `data[].removedByCategory` | string or null | yes | Why the post was removed: `moderator`, `deleted`, `author`, `automod_filtered`, `reddit`, and so on. Null while it is visible. |
| `data[].subredditSubscribers` | integer | yes | Members of the community at the time the post was read. · min 0 |
| `data[].postHint` | string or null | yes | What the post holds when Reddit says: `image`, `link`, `hosted:video`, `self`. |
| `data[].isVideo` | boolean | yes |  |
| `meta` | object | yes |  |
| `meta.requestId` | string | yes |  |
| `meta.nextCursor` | string or null | no |  |
| `meta.omittedNsfw` | integer | no | 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. · min 0 |

## Errors

| Status | Meaning | What to do |
| --- | --- | --- |
| `400` | The request failed validation. | The request was malformed. The `details` object names the field. |
| `401` | The API key is missing, malformed, expired, or revoked. | The key is missing, malformed, revoked, or expired. |
| `402` | The account is out of credit. Not retryable: this cannot clear until the billing period resets or the plan changes. | Out of credits. **Never retry.** Only a person can clear it, by adding credits at https://weirapp.io/dashboard/billing. Retrying never will. |
| `403` | The API key does not carry the scope this route requires. | The key is valid but lacks the scope this operation needs. |
| `404` | The requested resource does not exist. | No such resource, or it is not public. |
| `429` | The per-minute rate limit is exhausted. Retryable: wait for Retry-After and try again. | Rate limited. Retryable: wait for `Retry-After`, then try again. |
| `500` | An unexpected error occurred. | Something failed on our side. Retryable with backoff. |
| `503` | The source is temporarily unavailable. The request is safe to retry. | A source was unreachable. Retryable with backoff. |