User
Fetch a user profile and submissions.
GET
/v1/social-media:reddit/user/:usernamepassing · 1.9s5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| username | string | path | Reddit username (without the u/ prefix). Required. |
| after | string | query | Cursor from a previous response's `after` field. |
Example response
{"project":"social-media:reddit","data":null,"timestamp":"2026-08-06T11:23:21Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Post
Fetch a post and its comment discussion.
GET
/v1/social-media:reddit/post/:postIdpassing · 2.6s5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| postId | string | path | Reddit post ID, or a full reddit.com post URL. Required. |
| sub | string | query | Subreddit, only needed when it cannot be read from a URL. |
| limit | number | query | Max comments to return. Default 100. |
Example response
{"project":"social-media:reddit","data":null,"timestamp":"2026-08-06T11:23:21Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Subreddit
Fetch posts from a subreddit.
GET
/v1/social-media:reddit/subreddit/:subfailed last check5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| sub | string | path | Subreddit name (without the /r/ prefix). Required. |
| sort | enum | query | Listing sort order. Default hot. One of hot, new, top, rising. |
| time | enum | query | Time window, only meaningful when sort=top. One of hour, day, week, month, year, all. |
| after | string | query | Cursor from a previous response's `after` field. |
Example response
{"project":"social-media:reddit","data":null,"timestamp":"2026-08-06T11:23:21Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "social-media:reddit", "user", { username: "spez", after: "t3_1vdnb3e" });
Browse subreddits, users, and post discussions.
3 endpoints18 calls2/3 passing
Fetch a user profile and submissions.
GET
/v1/…reddit/user/:usernamepassing · 1.9s5m cache
Try it
Parameters
username
string · path · required
Reddit username (without the u/ prefix).
after
string · query · optional
Cursor from a previous response's `after` field.
Example response
{"project":"social-media:reddit","data":null,"timestamp":"2026-08-06T11:23:21Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "social-media:reddit", "user", { username: "spez", after: "t3_1vdnb3e" });