Skip to main content
POST
Reddit User Posts API

Reddit User Posts

Pull everything a Reddit user has posted, with the full text of self posts, the post link, score, comment count, publish time and any images or videos. Sort by newest to follow what someone is sharing right now, or by top to see which of their posts landed best. Handy for creator research, brand monitoring of a founder’s account, or building a dataset from a domain expert’s write-ups.
Provide one Reddit username in username. sort_by orders the posts by new (default), top or hot. results_limit defaults to 25 and accepts integers from 1 to 1000. Each post costs 0.5 credits; likes_count holds the post’s score.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide one Reddit username in username. sort_by orders the posts by new (default), top or hot. results_limit defaults to 25 and accepts integers from 1 to 1000.

username
string
required

Reddit username, with or without the u/ prefix.

Minimum string length: 1
callback_url
string<uri>
results_limit
integer
default:25
Required range: 1 <= x <= 1000
sort_by
enum<string>
default:new

Order of the posts: new, top or hot.

Available options:
hot,
new,
top
Minimum string length: 1

Response

Task accepted

code
integer
data
object