POST/api/v1/user-postsUsers

User Posts

Retrieve a paginated list of all posts submitted by a specific Reddit user across all subreddits.

Ready to try it?

Create a free account — 30 requests included, no credit card.

Request Parameters

Send as a JSON body in your POST request.

Parameter	Type	Required	Description
username	string	Yes	The Reddit username (without the 'u/').
sort	string	No	Sort order: 'hot', 'new', 'top', 'controversial'. Default: 'new'.
time	string	No	Time filter (for 'top'/'controversial'): 'hour', 'day', 'week', 'month', 'year', 'all'. Default: 'all'.
limit	number	No	Number of posts to return (max 100). Default: 25.
after	string	No	Pagination cursor (the 'name' of the last post).

Code Examples

curl

curl -X POST https://subscraper.dev/api/v1/user-posts \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "shittymorph",
    "sort": "top",
    "limit": 5
  }'

TypeScript SDK

const posts = await client.getUserPosts({
  username: "shittymorph",
  sort: "top",
  limit: 5
});

Install the SDK →

Sample Response

{
  "posts": [
    {
      "id": "t3_abc123",
      "title": "I made a thing",
      "subreddit": "DIY",
      "score": 45000,
      "numComments": 1200,
      "url": "https://reddit.com/r/DIY/...",
      "createdAt": "2020-05-12T10:00:00Z"
    }
  ],
  "after": "t3_abc123"
}