REDDIT API

Reddit User Activity API

List a Reddit user's recent activity, posts and comments together in the order they were made, as it appears on their profile. Page through older activity with `cursor`.

Endpoint
POST /reddit/list-user-overview
Price
1 credit per request
SDK
client.reddit.listUserOverview()
MCP tool
reddit_list_user_overview
Terminal
curl -X POST "https://api.bridgly.app/reddit/list-user-overview" \
-H "Authorization: Bearer $BRIDGLY_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "spez",
"count": 10
}'
[ REQUEST AND RESPONSE ]

What does the Reddit User Activity API return?

Reddit user activity API: list a Reddit user’s recent posts and comments together, newest first, as on their profile page, in one JSON response. 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",
"items": [
{
"type": "post",
"post": {
"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 Activity API?

One activity feed

Show everything a user did recently in a single timeline.

Spot active accounts

Check how recently and how often someone participates.

Feed an agent

Give a model a user’s recent activity to summarize.

[ FAQ ]

Reddit User Activity API questions

How is this different from the user posts and comments endpoints?

It returns posts and comments mixed in the order they were made, like the Overview tab of a profile. Use the other two when you only want one kind.

How do I get a timeline of a Reddit user’s activity?

Send the username. Each item says whether it is a post or a comment, so you can see what the user did and when, up to 10 items per call; send the nextCursor back as cursor for older ones.

How do I use the Reddit User Activity API?

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

How much does the Reddit User Activity 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.

Try the Reddit User Activity 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