reddit/
user-posts

The Reddit User Posts API collects up to 1000 posts a Reddit user has submitted from one username, sorted by new, top or hot, returning title and body text, net score, comment count and media.

Reddit User Posts API

Username input
new / top / hot sorting
Up to 1000 posts
Score and comments
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
usernameRequiredOne Reddit username, with or without the u/ prefix, made of 3 to 20 letters, digits, hyphens or underscores.
sort_byOptionalOrder of the posts: new (default), top or hot.
results_limitOptionalMaximum 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.

  1. POST {"username": "spez", "sort_by": "new", "results_limit": 25} to /v1/reddit/user-posts.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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.

Explore other platforms

Combine Reddit data with public data from other supported social platforms.

Reddit User Posts API — FAQ

Reddit User Posts API is a programmatic interface for collecting the posts a Reddit account has submitted, starting from its username. It returns each post's title and body text, link, publish time, score, comment count and attached media.

Send the username to the Reddit User Posts API with sort_by set to new and a results_limit of up to 1000, then page through the results with next_cursor until has_more is false.

new lists the account's posts from the latest backwards, top orders them by score, and hot follows Reddit's hot ranking for the profile. When sort_by is left out, new is used.

The Reddit User Posts API charges 0.5 credits for each post returned, so the default 25 posts cost 12.5 credits and 1000 posts cost 500. An account with fewer posts than results_limit is charged only for the posts it returns.