Reddit User Posts API

Reddit User Posts API — list every post a Reddit account has submitted, sorted by new, hot, or top. JSON with scores, comment counts, and media for $0.01 per call.

POST/v1/reddit/user-posts

$0.01/call

The Reddit User Posts API returns the posts a Reddit account has made, newest first by default. Switch sort to hot or top (with a time window) to find the account's most popular posts. Profile details are on the Reddit User API.

Usage

const res = await fetch('https://api.yepapi.com/v1/reddit/user-posts', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"username": "spez"}),
});
const { data } = await res.json();
console.log(data);

curl -X POST https://api.yepapi.com/v1/reddit/user-posts \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "spez"}'

import requests

res = requests.post(
    "https://api.yepapi.com/v1/reddit/user-posts",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"username": "spez"},
)
print(res.json()["data"])

Request Body

Parameter	Type	Required	Description	Default
`username`	`string`	Yes	Reddit username — `spez`, `u/spez`, or a reddit.com/user/spez URL (3–20 characters)	—
`sort`	`string`	No	One of: `new`, `hot`, `top`	`new`
`time`	`string`	No	Time window, only used with `sort: "top"`. One of: `hour`, `day`, `week`, `month`, `year`, `all`	`day`
`cursor`	`string`	No	`cursor` from the previous response, to fetch the next page	—

Response

{
  "ok": true,
  "data": {
    "cursor": null,
    "posts": [
      {
        "author": "spez",
        "created_at": "2026-10-29T20:08:37+00:00",
        "created_utc": 1793304517,
        "domain": "self.spez",
        "flair": null,
        "id": "1xiupm0",
        "images": [],
        "is_self": true,
        "is_video": false,
        "locked": false,
        "name": "t3_1xiupm0",
        "num_comments": 362,
        "num_crossposts": 2,
        "over_18": false,
        "permalink": "https://www.reddit.com/r/u_spez/comments/1xiupm0/about_that_login_screen/",
        "score": 0,
        "selftext": "I want to talk about a big change we're making on Reddit: we're going to evolve Reddit to being a primarily logged-in experience.\n\nThis is a big change for Reddit, where we've allowed logged-out acces…",
        "spoiler": false,
        "stickied": false,
        "subreddit": "u_spez",
        "thumbnail": null,
        "title": "About that login screen",
        "upvote_ratio": 0.29,
        "url": "https://www.reddit.com/r/u_spez/comments/1xiupm0/about_that_login_screen/",
        "video_url": null
      },
      {
        "author": "spez",
        "created_at": "2026-08-05T16:03:56+00:00",
        "created_utc": 1785945836,
        "domain": "self.spez",
        "flair": null,
        "id": "1vgbkge",
        "images": [
          "https://external-preview.redd.it/-_NM9QKmwnaF7Ti3sXwY6oJD9PVQrQGXBx1288oLFXw.png?auto=webp&s=58d39b335111d200e60a1e6fa3ce9499441410bd"
        ],
        "is_self": true,
        "is_video": false,
        "locked": false,
        "name": "t3_1vgbkge",
        "num_comments": 488,
        "num_crossposts": 7,
        "over_18": false,
        "permalink": "https://www.reddit.com/r/u_spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/",
        "score": 376,
        "selftext": "Hi everyone,\n\nLast May, I shared how we were building Reddit for its [next chapter](https://www.reddit.com/user/spez/comments/1kfciml/reddits_next_chapter_smarter_easier_still_human/). I owe you an up…",
        "spoiler": false,
        "stickied": false,
        "subreddit": "u_spez",
        "thumbnail": null,
        "title": "Modernizing Reddit’s infrastructure with you",
        "upvote_ratio": 0.84,
        "url": "https://www.reddit.com/r/u_spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/",
        "video_url": null
      }
    ]
  }
}

Response Fields

Field	Type	Description
`ok`	`boolean`	Whether the request succeeded
`data.posts`	`object[]`	The account's posts
`data.posts[].id`	`string`	Post ID (base36)
`data.posts[].name`	`string`	Fullname, `t3_` + ID — the same value Reddit uses in cursors
`data.posts[].title`	`string`	Post title
`data.posts[].author`	`string`	Author username
`data.posts[].subreddit`	`string`	Subreddit name without `r/`
`data.posts[].permalink`	`string`	Full reddit.com URL of the post — pass it to `/v1/reddit/post` or `/v1/reddit/post-comments`
`data.posts[].url`	`string`	Link target: the external URL, image, or the post itself for text posts
`data.posts[].domain`	`string`	Domain of `url` (`self.<subreddit>` for text posts)
`data.posts[].selftext`	`string`	Body of a text post in Markdown (empty for link posts)
`data.posts[].score`	`number`	Net upvotes
`data.posts[].upvote_ratio`	`number`	Share of upvotes, 0–1
`data.posts[].num_comments`	`number`	Comment count
`data.posts[].num_crossposts`	`number`	Crosspost count
`data.posts[].created_utc`	`number`	Unix timestamp (seconds)
`data.posts[].created_at`	`string`	ISO 8601 timestamp
`data.posts[].flair`	`string \| null`	Post flair text
`data.posts[].is_self`	`boolean`	Text post (no external link)
`data.posts[].is_video`	`boolean`	Reddit-hosted video
`data.posts[].over_18`	`boolean`	Marked NSFW
`data.posts[].spoiler`	`boolean`	Marked as spoiler
`data.posts[].stickied`	`boolean`	Pinned by moderators
`data.posts[].locked`	`boolean`	Comments locked
`data.posts[].thumbnail`	`string \| null`	Thumbnail image URL
`data.posts[].images`	`string[]`	Full-size image URLs (preview images and gallery items)
`data.posts[].video_url`	`string \| null`	MP4 URL for Reddit-hosted videos
`data.cursor`	`string \| null`	Cursor for the next page

Pagination

Each response includes a cursor. Send the same request again with that value in cursor to get the next page. When cursor is null, there are no more results. A query with no matches returns 200 with an empty list and cursor: null. Every page is a separate $0.01 call.

Caching

Responses are cached for 15 minutes.

Errors

Status	Code	When
`400`	`VALIDATION_ERROR`	`username` is invalid, or `sort` / `time` is not an allowed value
`429`	`RATE_LIMITED_UPSTREAM`	Too many requests in a short burst — retry after a few seconds
`502`	`UPSTREAM_ERROR`	Temporary problem fetching data from Reddit — retry

Failed calls are not charged.

An account that doesn't exist or has no posts returns 200 with an empty posts list. Use /v1/reddit/user to check whether an account exists.

Reddit User API — profile and karma
Reddit User Comments API — the account's comments
Reddit Comments API — comments on any of these posts

Reddit User Posts API

On this page