Reddit API: List user activity

List an account's posts and comments in one activity feed. Each row identifies its type in kind.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

username*string

Account name, e.g. spez. Accepts u/spez or a reddit.com /user/ or /u/ URL. 2-20 letters, digits, underscores or hyphens. An account with no activity returns an empty feed.

Lengthlength <= 300

count?integer

How many items to return after include is applied. Posts are rarer than comments, so include=posts may return fewer than count once the feed runs out; end_of_feed says when.

Range1 <= value <= 200

Default25

include?string

Which items to keep: all (default), posts or comments. Every row states its kind. posts is slowest because most items on active accounts are comments.

Default"all"

Value in

"all"
"posts"
"comments"

after?string

next_cursor from the previous response; omit for the top of the feed. Always send the cursor as returned: it points at the last item of any kind, and a cursor built from a post id can stall.

Lengthlength <= 200

curl -X GET "https://example.com/v1/reddit/user-posts?username=spez" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "items": [      {        "kind": "post",        "id": "1vay198",        "fullname": "t3_1vay198",        "permalink": "/r/technology/comments/1vay198/example_post_title/",        "url": "https://www.reddit.com/r/technology/comments/1vay198/example/",        "title": "Example post title",        "subreddit": "technology",        "subreddit_prefixed": "r/technology",        "subreddit_id": "t5_2qh16",        "author": "example_user",        "author_id": "t2_abc123",        "author_icon": null,        "created_at": "2026-08-17T09:14:22.000+0000",        "score": 1284,        "upvote_ratio": 0.94,        "comment_count": 213,        "award_count": 0,        "domain": "arstechnica.com",        "content_url": "https://arstechnica.com/example-article/",        "post_type": "link",        "flair": "Society",        "flair_url": "/r/technology/?f=flair_name%3A%22Society%22",        "thumbnail": "https://external-preview.redd.it/example.jpg",        "media": {          "kind": "image",          "url": "https://i.redd.it/example.jpeg",          "poster": null,          "preview": null,          "caption_url": null,          "items": null        },        "text": null,        "nsfw": null,        "spoiler": false,        "locked": false,        "archived": false,        "language": "en"      }    ],    "username": "spez",    "include": "all",    "count": 25,    "post_count": 2,    "comment_count": 23,    "requested_count": 25,    "next_cursor": "dDFfcDQ0cWRwZA==",    "end_of_feed": false,    "pages_fetched": 4,    "usage_note": "Reddit's 'overview' is ONE feed carrying posts and comments interleaved, with no server-side filter — every row says which it is in `kind`, and `include` filters them here rather than upstream. An active account runs roughly 1 post to 10 comments, so include=posts walks a lot of pages for a few rows and may return fewer than `count`; `end_of_feed` says whether that was the account ending or the page budget. `next_cursor` is normally a COMMENT's fullname, because this feed's cursor is the last item and the last item is usually a comment."  }}