SocQ already covered Reddit posts, comments, subreddit listings and search. On 2026-11-17 it added seven endpoints that answer different questions: who is this Reddit user, what do they post and say, and where are they active, plus what is trending across Reddit and what each subreddit allows.
This guide covers what each new endpoint returns, the request, the price and when to use it. For Reddit's official API, OAuth and the endpoints that launched earlier, read the Reddit API guide and the Reddit scraper API comparison.
Quick answer: Send a username, a subreddit URL or no input at all to one of the seven
POST /v1/reddit/...endpoints withAuthorization: Bearer $SOCQ_API_KEY. PollGET /v1/tasks/{task_id}untilstatusissucceeded, then readdata.results.items. Five endpoints bill per result (0.3 or 0.5 credits); Active Subreddits and Trending Searches cost 0.5 credits per call. One credit is $0.005.
The Seven New Reddit Endpoints
| Endpoint | What it returns | Price |
|---|---|---|
| User Profile | Karma (post and comment), post and comment counts, account age, description, avatar, trophies, verified and employee flags | 0.5 credits ($0.0025) per account |
| User Posts | A user's posts by new, top or hot, with full text, score, comments and media | 0.5 credits ($0.0025) per post |
| User Comments | A user's comments with score, time, link and the post each was left on | 0.3 credits ($0.0015) per comment |
| User Active Subreddits | Subreddits the user is active in, with member counts and descriptions | 0.5 credits ($0.0025) per call |
| Popular Feed | Posts on r/popular by best, hot, new, top or rising | 0.5 credits ($0.0025) per post |
| Trending Searches | Today's trending Reddit searches, ranked | 0.5 credits ($0.0025) per call |
| Subreddit Rules | Numbered rules with short title and full text | 0.5 credits ($0.0025) per subreddit |
Research a Reddit User
Reddit User Profile
The Reddit User Profile API returns one row per account: total karma split into post and comment karma, how many posts and comments the account has made, when it was created, its profile description and avatar, trophy count, and flags for verified accounts and Reddit employees. Use it to vet a creator before outreach or to judge how established the authors in a thread are.
curl -X POST "https://api.socq.ai/v1/reddit/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"usernames": ["spez", "GovSchwarzenegger"]
}'
Send up to 100 usernames, with or without the u/ prefix. See the User Profile docs.
Reddit User Posts
The Reddit User Posts API pulls a user's post history with the full text of self posts, post link, score, comment count, publish time and any images or videos. Sort by new to follow what someone shares now, or by top to see which posts landed best.
curl -X POST "https://api.socq.ai/v1/reddit/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "spez",
"sort_by": "new",
"results_limit": 25
}'
sort_by is new (default), top or hot. results_limit defaults to 25 and accepts 1 to 1,000. likes_count holds the post's score. See the User Posts docs.
Reddit User Comments
Comment history shows what someone knows and cares about better than their own posts. The Reddit User Comments API returns each comment with its score, time, a link to the comment and the post_id of the post it was left on. Use it to qualify experts and potential customers, or to track how an account talks about your product.
curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "spez",
"sort_by": "top",
"results_limit": 100
}'
results_limit defaults to 100 and accepts 1 to 1,000. text holds a preview of up to 300 characters; url opens the full comment. See the User Comments docs.
Reddit User Active Subreddits
The Reddit User Active Subreddits API lists the communities a user has recently posted or commented in, each with member count and description. It maps someone's interests and points you to the niche communities your audience uses.
curl -X POST "https://api.socq.ai/v1/reddit/user-active-subreddits" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "GovSchwarzenegger"
}'
One request costs 0.5 credits and returns every community on the account's public active list. See the Active Subreddits docs.
Watch What Is Trending on Reddit
Reddit Popular Feed
The Reddit Popular Feed API reads r/popular the way Reddit shows it: posts rising across all communities, with title and body, link, author, score, comment count and media. Switch sort_by to top and set published_within to see what broke through over a day or a week.
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sort_by": "hot",
"results_limit": 25
}'
All fields are optional. sort_by is best, hot (default), new, top or rising; published_within applies to top and runs from hour to all. results_limit defaults to 25 and accepts 1 to 500. See the Popular Feed docs.
Reddit Trending Searches
The Reddit Trending Searches API returns today's trending searches in the order Reddit lists them, often news events, product launches and cultural moments as they unfold. Poll it a few times a day for a trend dashboard, then dig into a topic with Reddit Search.
curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
No input is needed. Each call returns the current list, usually six searches, ranked from 1. See the Trending Searches docs.
Check a Subreddit's Rules Before Posting
The Reddit Subreddit Rules API returns one row per subreddit with its numbered rules in order, each with the short title moderators show in the report menu and the full rule text. Brands use it to check what is allowed before a launch post; teams running many accounts keep a rulebook per community.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.reddit.com/r/AskReddit/"]
}'
See the Subreddit Rules docs.
Authentication and the Async Task Flow
Every request carries your API key and a JSON content type:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Each submit call starts a background task (submit -> task_id -> queued -> running -> succeeded, or failed). The submit response returns data.task_id and data.status. Poll the task:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
While the task is queued, running or failed, the response holds task metadata only; on failed, read error_message. When it is succeeded, the response includes the first page of normalized records in data.results.items. limit defaults to 50 and goes up to 500. If has_more is true, pass results.next_cursor as cursor. fields accepts up to 50 comma-separated fields or dot paths.
A client-side timeout does not cancel a task; resume with the same task_id instead of paying for a duplicate. You can also add callback_url to the submit body to receive one POST with a task summary when the task finishes.
What a Typical Job Costs
- Profile 100 thread authors: 100 × 0.5 = 50 credits, $0.25.
- Full read on one user (25 posts, 100 comments, active subreddits): 12.5 + 30 + 0.5 = 43 credits, $0.215.
- Trending searches four times a day for 30 days: 120 × 0.5 = 60 credits, $0.30.
FAQ
Can I look up many Reddit users at once?
User Profile takes up to 100 usernames per request. User Posts, User Comments and Active Subreddits take one username each, so submit one task per user.
Does User Comments return the full comment text?
text holds a preview of up to 300 characters. The url field opens the full comment, and post_id identifies the post it was left on.
How is Popular Feed different from Subreddit Posts?
Popular Feed reads r/popular, which mixes posts rising across all communities. To read one community, use Subreddit Posts.
Do I pay when a user has no posts?
The per-result endpoints have no base fee, so an empty result costs nothing. Active Subreddits and Trending Searches are flat 0.5-credit calls.
Where do I compare Reddit data providers?
See Reddit API alternatives. All SocQ Reddit endpoints are on the Reddit platform page, with current rates on the pricing page.
REDDIT API
Test the workflow with a public Reddit URL
Submit public inputs and receive normalized records with traceable source context.
Explore Reddit APIs