Reddit User Profile
A Reddit user profile is the public account page behind a u/ name, showing total karma split between posts and comments, how many posts and comments the account has made, its creation date, description, avatar, trophies and badges for verified accounts and Reddit employees. Together these signals show how established and how active an account is, which supports vetting creators, screening new or low-karma accounts and following influential members of a niche over time.
Reddit User Profile API Features
- Up to 100 usernames per requestEach Reddit User Profile API request takes up to 100 names in usernames, written with or without the u/ prefix, and every account that exists comes back as its own row.
- Karma split by sourcemetrics.karma_count gives total karma, while post_karma_count and comment_karma_count show whether it was earned by submitting posts or by commenting.
- Activity counts and account ageposts_count and comments_count measure how much the account has contributed, and published_at records the moment it was created.
- Profile badges and trophiesis_verified, is_employee and is_nsfw carry Reddit's own account flags and trophies_count sizes the trophy case, next to the display name, description, avatar and banner.
Reddit User Profile API Parameters
| Parameters | Required | Description |
|---|---|---|
usernames | Required | Up to 100 Reddit usernames, with or without the u/ prefix; each name is 3 to 20 letters, digits, hyphens or underscores. |
How to Use the Reddit User Profile API
Send a list of Reddit usernames to the Reddit User Profile API and read one profile row per existing account.
- POST {"usernames": ["spez", "GovSchwarzenegger"]} to /v1/reddit/user-profile.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read the profiles from results.items and keep requesting with results.next_cursor while has_more is true.
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"]}'Reddit User Profile API Use Cases
- Vetting a creator before outreach: Check karma_count, posts_count and published_at to confirm that a Redditor you plan to contact has a long and active history.
- Screening new or low-karma accounts: Flag usernames with a recent published_at and a low karma_count when reviewing the authors behind a wave of similar posts or comments.
- Tracking a watchlist of niche accounts: Re-run the same usernames on a schedule and compare karma_count, posts_count and followers_count to see which members are growing.
- Enriching a list of Reddit handles: Add the display name, description, avatar_url and profile url from the Reddit User Profile API to usernames gathered from threads, so a spreadsheet or CRM shows who each person is.
Reddit User Profile API Pro Tips
- Clean names before submitting: after the u/ prefix each must be 3 to 20 letters, digits, hyphens or underscores, and one malformed entry rejects the whole request.
- Match rows back to your input by lowercased username, because a name submitted twice in different casing is looked up once and returns a single row.
- Split lists longer than 100 names into batches of 100 and merge the results on id, the account's permanent Reddit identifier.
Related APIs
Beyond the Reddit User Profile API, use these APIs when you need a different type of public Reddit data.
- Reddit Posts API — Collect public post text, authors, community context, media, timestamps, and visible engagement from supported Reddit URLs.
- Reddit Subreddit Details API
- Reddit User Posts API — Collect a Reddit user's post history from one username, sorted by new, top or hot, with title and body, score, comments and media.
- Reddit User Comments API — Collect a Reddit user's comment history from one username, with 300-character excerpts, scores, comment links and post IDs.
- Reddit User Active Subreddits API — List the subreddits a Reddit user is active in from one username, with member counts and descriptions.
- Reddit Subreddit Rules API — Retrieve the numbered rules of subreddits from their URLs, with each rule's short title and full text.