RedditReddit UsersSubreddit RulesTrendingAPI Guide

Reddit User API: Profiles, Post and Comment History, Trends and Rules

Seven new SocQ Reddit endpoints: user profiles, post and comment history, active subreddits, r/popular, trending searches and subreddit rules, with requests and per-result prices.

SocQUpdated November 19, 20267 min read

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 with Authorization: Bearer $SOCQ_API_KEY. Poll GET /v1/tasks/{task_id} until status is succeeded, then read data.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

EndpointWhat it returnsPrice
User ProfileKarma (post and comment), post and comment counts, account age, description, avatar, trophies, verified and employee flags0.5 credits ($0.0025) per account
User PostsA user's posts by new, top or hot, with full text, score, comments and media0.5 credits ($0.0025) per post
User CommentsA user's comments with score, time, link and the post each was left on0.3 credits ($0.0015) per comment
User Active SubredditsSubreddits the user is active in, with member counts and descriptions0.5 credits ($0.0025) per call
Popular FeedPosts on r/popular by best, hot, new, top or rising0.5 credits ($0.0025) per post
Trending SearchesToday's trending Reddit searches, ranked0.5 credits ($0.0025) per call
Subreddit RulesNumbered rules with short title and full text0.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.

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.

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.

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