Get a Reddit User's Submitted Posts

Fetch a Reddit user's submitted posts by username, sorted by new, top, hot, or controversial. Same shape as subreddit listings, with cursor pagination.

GET/api/reddit/user/:name/submitted$0.002 / call

A user's submitted posts, their post history. The sibling of GET /api/reddit/user/:name/comments, which returns their comments instead.

When to use this

Reach for this when you want what a redditor has posted, not what they have commented on: profiling an author, pulling a creator's back-catalog, or checking which communities someone submits to. Returns the same post shape as /api/reddit/posts, so every post field (upvotes, comments, link_url, crosspost data, and so on) is the same.

Path Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Reddit username (no `u/` prefix)

Query Parameters

Parameter	Type	Required	Description
`sort`	string	No	`new` (default) \| `top` \| `hot` \| `controversial`
`t`	string	No	Timeframe for `sort=top`/`controversial`: `hour` \| `day` \| `week` \| `month` \| `year` \| `all`
`limit`	number	No	Number of posts to return, `1`-`100` (default `25`)
`after`	string	No	Pagination cursor. Pass back the `after` value from the previous response exactly as issued; it is opaque and carries your paging depth. See Pagination depth.

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/api/reddit/user/spez/submitted?sort=top&t=year"

const response = await fetch(
  "https://api.redditapis.com/api/reddit/user/spez/submitted?sort=top&t=year",
  { headers: { Authorization: "Bearer TOKEN" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.redditapis.com/api/reddit/user/spez/submitted",
    params={"sort": "top", "t": "year"},
    headers={"Authorization": "Bearer TOKEN"},
)

Response Shape

{
  "posts": [
    {
      "id": "1tkez6e",
      "name": "t3_1tkez6e",
      "title": "...",
      "author": "spez",
      "permalink": "/r/announcements/comments/1tkez6e/...",
      "url": "https://reddit.com/r/announcements/comments/1tkez6e/...",
      "link_url": null,
      "text": "...",
      "subreddit": "announcements",
      "upvotes": 4210,
      "comments": 1200,
      "created_utc": 1779445765,
      "created": "2026-05-22T10:29:25.000Z"
    }
  ],
  "after": "t3_xyz"
}

Same post object as /api/reddit/posts, see that page for the full per-post field reference (author_info, upvote_ratio, is_crosspost, crosspost_origin, and the post flags).

Response Fields

Field	Type	Notes
`id`	string	Post id without prefix
`name`	string	Full id with `t3_` prefix. This is Reddit's own id for the post, NOT a pagination cursor. Use the response's `after` value for paging.
`title`	string	Post title
`author`	string	Username (no `u/` prefix)
`permalink`	string	Path on reddit.com
`url`	string	Full reddit.com URL
`link_url`	string \| null	External link / media URL. `null` for self/text posts.
`text`	string	Self-post body (empty for link/image posts)
`subreddit`	string	Subreddit the post is in (no `r/` prefix)
`upvotes`	number	Net votes (upvotes − downvotes)
`comments`	number	Comment count
`created`	string	ISO-8601 timestamp of the post
`after`	string \| null	Cursor for the next page, or `null` when there is no next page to request. An empty cursor does not always mean you have every item, so read `listing_status` (below) to find out which. See Pagination depth.

When `after` comes back empty

An empty cursor means there is no next page to ask for. It does not always mean you have every post: Reddit often stops serving a busy listing long before it runs out. Paging r/all on 2026-08-14 stopped after 400 posts covering about a minute of a feed that plainly holds more.

The response tells you which happened. When after is null it also carries listing_status, which reads complete, truncated or unknown. Only complete means you have everything; treat the other two as a partial answer and widen your search rather than stopping. The full field list and what to do about each answer is in Pagination depth.

Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.