Reddit User Posts
A Reddit user's post history is the list of submissions an account has made across communities, each with its title and body, link, publish time, net score, comment count and any attached images or video. Read by date or by score, it shows what a person shares, which of their topics gain traction and how their output shifts over time, which feeds creator research, monitoring of a founder's account and the collection of an expert's long-form write-ups.
Reddit User Posts API Features
- One username, up to 1000 postsusername takes a single account with or without the u/ prefix, and results_limit collects anywhere from 1 to 1000 of its posts, 25 by default.
- Title and body in one text fieldIn each Reddit User Posts API row, text opens with the post title and, for self posts, follows it with a blank line and the full body, so one field holds the whole written post.
- Net score and comment countmetrics.likes_count is the post's score, upvotes minus downvotes, and metrics.comments_count shows how much discussion the post drew.
- Images, galleries and hosted videomedia lists every attached image or video with its url, preview image and width and height in pixels, ready for thumbnails or downloads.
Reddit User Posts API Parameters
| Parameters | Required | Description |
|---|---|---|
username | Required | One Reddit username, with or without the u/ prefix, made of 3 to 20 letters, digits, hyphens or underscores. |
sort_by | Optional | Order of the posts: new (default), top or hot. |
results_limit | Optional | Maximum number of posts to collect, an integer from 1 to 1000; defaults to 25. |
How to Use the Reddit User Posts API
Submit one username to the Reddit User Posts API with a sort order and a limit, then page through the posts.
- POST {"username": "spez", "sort_by": "new", "results_limit": 25} to /v1/reddit/user-posts.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read the posts from results.items, and while has_more is true pass results.next_cursor to load the next page.
curl -X POST "https://api.socq.ai/v1/reddit/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"spez","sort_by":"new","results_limit":25}'Reddit User Posts API Use Cases
- Following an account's latest submissions: Run sort_by new on a schedule and read published_at and url to catch each new post from a founder, journalist or competitor account.
- Ranking a user's highest-scoring posts: Request sort_by top from the Reddit User Posts API and compare likes_count with comments_count to see which of someone's topics and formats drew the strongest response.
- Building a corpus from an expert's write-ups: Store the text of self posts with their url and published_at to assemble a dataset of one specialist's long-form explanations.
Reddit User Posts API Pro Tips
- Split text at the first blank line to separate the title from the body; link and media posts hold only their title.
- When checking an account for new posts with sort_by new, keep the ids you already stored and stop reading pages once a known id appears.
- Collect the same username with the Reddit User Comments API when you need the account's whole activity, since its replies in other people's threads are returned there.
Related APIs
Beyond the Reddit User Posts API, use these APIs when you need a different type of public Reddit data.
- Reddit Posts API — Collect public post text, authors, community context, media, timestamps, and visible engagement from supported Reddit URLs.
- Reddit Comments API — Collect public comment text, authors, post and parent-comment references, community context, timestamps, and visible engagement from supported post URLs.
- Reddit Subreddit Posts API — Discover public posts from subreddit URLs with new, top, or hot sorting, a per-subreddit result limit, and normalized community and engagement context.
- Reddit User Profile API — Look up Reddit accounts by username, returning total, post and comment karma, activity counts, account age and profile flags.
- Reddit User Active Subreddits API — List the subreddits a Reddit user is active in from one username, with member counts and descriptions.
- Reddit Popular Feed API — Collect r/popular posts in hot, best, new, rising or top order, with title and body, author, score, comments and media.