All questionsReddit

How do I get a Reddit user’s post history?

Call GET /v1/reddit/profiles/@username/posts with sort=new. Each request returns one page of the user’s public posts with title, subreddit, score, and comment count. Pass the cursor back for the next page. For their comments, call GET /v1/reddit/profiles/@username/comments.

You get what Reddit shows on the user page now. Posts the user deleted or a moderator removed are not there. A suspended account returns PROFILE_NOT_FOUND.

Checked September 2026 · request and response run against the API · no affiliate links

Get started for $0 Quickstart

GET /v1/reddit/profiles/@username/posts?sort=new

curl "https://api.openhandle.dev/v1/reddit/profiles/@synthetic_reddit/posts?sort=new" \
  -H "Authorization: Bearer $OPENHANDLE_API_KEY"

TypeScript SDK

import { OpenHandle } from '@openhandle/sdk';

const openhandle = new OpenHandle({ apiKey: process.env.OPENHANDLE_API_KEY! });
let page = await openhandle.reddit.profile('synthetic_reddit').posts.list({ sort: 'new' });

while (page) {
    for (const post of page.data) console.log(post.community.displayHandle, post.title);
    page = await page.next();
}

200 OK

{
  "platform": "reddit",
  "resource": "post",
  "capturedAt": "2026-09-18T12:47:12Z",
  "source": "live",
  "data": [
    {
      "id": "t3_reddit1",
      "title": "Synthetic Reddit post",
      "community": { "handle": "synthetic", "displayHandle": "r/synthetic" },
      "createdAt": "2026-08-09T15:30:00Z",
      "metrics": { "score": 0, "upvoteRatio": 0.5, "comments": 0 }
    }
  ],
  "meta": { "cursors": { "next": "b3BhcXVlLWN1cnNvcg" } }
}

Trimmed to one post. Reddit endpoints are in beta. The example is a Test profile, so you can run it on a free Test key.

The profile itself

GET /v1/reddit/profiles/@username returns the account: id, handle, bio, account age, follower count, and karma split into post and comment karma where Reddit shows it. Store the id. Reddit usernames do not change, but the ID is the stable key across every platform in the API.

Sort and window

—new. Newest first. The right sort for a history.
—top with t. sort=top&t=year gives the user’s best-scoring posts of the year. Use t=all for their best ever.
—Comments. The comments endpoint takes the same sorts. Comment history is usually longer and says more about the person.

What is not there

—Deleted or removed items. Reddit shows them to nobody. Neither do we. There is no archive behind the API.
—Private or quarantined communities. Posts inside them answer as Reddit shows them to a logged-out visitor, which is usually not at all.
—Votes and saved items. Private to the user. Never public.

When this does not work

These answers are definitive. Store them, do not retry them.

Situation	Status	Code
The account is suspended, deleted, or never existed	404	PROFILE_NOT_FOUND
The cursor came from another sort or window	400	CURSOR_MISMATCH
The username is malformed	400	INVALID_IDENTIFIER

404 Not Found

{
  "error": {
    "code": "PROFILE_NOT_FOUND",
    "message": "This profile was not found.",
    "requestId": "req_01j8…",
    "retryable": false
  }
}

Reddit endpoints are in beta. The shape is stable, coverage is still growing. Failed requests are never billed.

Send your agent ahead.

Paste the prompt into your agent and it sets everything up. Or come yourself, it takes five minutes.

For agents

Get started for $0 Read the quickstart