ToolzerHub Docs

List user activity (v1)

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

1 credit / requestBilled only on success
GET
/v1/reddit/user-posts

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
include?string

Which items to keep from the page: all (default), posts or comments. Every row states its kind. Most items on active accounts are comments, so a posts page can be short or empty while next_cursor is still set.

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,    "next_cursor": "dDFfcDQ0cWRwZA==",    "end_of_feed": false,    "usage_note": "One page of the account's overview feed, posts and comments interleaved; `kind` says which. `include` filters this page, so `include=posts` can return few or no rows while `next_cursor` is still set. Always send `next_cursor` back as returned."  },  "details": {    "reason": "no_results",    "message": "string"  }}