Reddit User Posts API

List the most recent posts a Reddit user has submitted, with the title, body, subreddit, score, comment count and link of each. Page through older posts with `cursor`.

Endpoint: POST /reddit/list-user-posts
Price: 1 credit per request
SDK: client.reddit.listUserPosts()
MCP tool: reddit_list_user_posts

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/reddit/list-user-posts" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "username": "spez",
  "count": 10
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/reddit/list-user-posts",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "username": "spez",
        "count": 10,
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/reddit/list-user-posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "username": "spez",
    "count": 10
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.reddit.listUserPosts({
  username: "spez",
  count: 10
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Reddit User Posts API return?

Reddit user posts API: list the most recent posts any Reddit user submitted, with title, body, subreddit, score, comment count and link, as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.
usernamestringrequired: Reddit username, with or without the "u/" prefix, or the profile link, e.g. "spez" or "https://www.reddit.com/user/spez/".
countinteger · 1–10 · default 10: Number of results to return (1–10). Defaults to 10.
sortenum: Result ordering. Defaults to "new".; new | hot | top | controversial
timeenum: Time window for the "top" and "controversial" sorts. Defaults to "all".; hour | day | week | month | year | all

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "posts": [
      {
        "id": "string",
        "fullname": "string",
        "title": "string",
        "author": "string",
        "authorFullname": "string",
        "selftext": "string",
        "score": 0,
        "ups": 0,
        "downs": 0,
        "upvoteRatio": 0,
        "numComments": 0,
        "numCrossposts": 0,
        "totalAwardsReceived": 0,
        "gilded": 0,
        "createdUtc": 0,
        "createdAt": "string",
        "editedUtc": 0,
        "editedAt": "string",
        "permalink": "string",
        "postUrl": "string",
        "url": "string",
        "subreddit": "string",
        "subredditId": "string",
        "subredditUrl": "string",
        "subredditPrefixed": "string",
        "subredditSubscribers": 0,
        "subredditType": "string",
        "linkFlairText": "string",
        "domain": "string",
        "thumbnail": "string",
        "distinguished": "string",
        "isSelf": true,
        "isVideo": true,
        "isOriginalContent": true,
        "over18": true,
        "spoiler": true,
        "stickied": true,
        "pinned": true,
        "archived": true,
        "contestMode": true,
        "locked": true
      }
    ]
  }
}

[ USE CASES ]

What can you build with the Reddit User Posts API?

Profile a poster

See which subreddits someone posts in and how their posts perform.

Track brand accounts

Follow what official or competitor accounts publish on Reddit.

Detect spam

Flag accounts that post the same link across many communities.

[ FAQ ]

Reddit User Posts API questions

How do I get the posts a Reddit user has made?

Send the username. You get their most recent submissions, up to 10 per call, each with title, body, subreddit, score, comment count and link; send the nextCursor back as cursor for older ones.

Can I see which subreddits a user posts in?

Yes. Each post carries its subreddit, so counting them shows where a user is active, which helps when vetting a creator or finding communities to join.

How do I use the Reddit User Posts API?

Send a POST request to https://api.bridgly.app/reddit/list-user-posts with username in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.reddit.listUserPosts(). AI agents connected to Bridgly over MCP can call the reddit_list_user_posts tool.

How much does the Reddit User Posts API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More Reddit endpoints

The same API key works on every endpoint. See all Reddit API endpoints.

Try the Reddit User Posts API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs