Get a Reddit User Profile and Karma
Fetch a Reddit user's full profile by username: karma sub-buckets, creation date, employee/gold/verified flags, icon, banner, bio and profile-sub data.
/api/reddit/user/:name$0.0015 / callUser profile with karma, account flags, profile icon + snoovatar, and the user's profile-subreddit metadata (display name, bio, banner, NSFW flag).
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Reddit username (no u/ prefix) |
GET /api/reddit/user?name={name} (or ?username={name}) returns the same thing at the same price. Leaving the name out is a free 404 with code: "NAME_REQUIRED" (not billed, like any unknown path).
Response (200)
{
"name": "spez",
"id": "1w72",
"fullname": "t2_1w72",
"created_utc": 1118030400,
"created": "2005-06-06T04:00:00.000Z",
"link_karma": 182650,
"comment_karma": 755338,
"awardee_karma": 0,
"awarder_karma": 0,
"total_karma": 937988,
"is_gold": true,
"is_mod": true,
"is_employee": true,
"verified": true,
"has_verified_email": true,
"accept_followers": true,
"icon_img": "https://styles.redditmedia.com/...",
"snoovatar_img": null,
"subreddit": {
"name": "t5_3k30p",
"display_name": "u_spez",
"display_name_prefixed": "u/spez",
"title": "spez",
"public_description": "Reddit CEO",
"description": null,
"banner_img": "https://b.thumbs.redditmedia.com/...",
"subscribers": 0,
"url": "/user/spez/",
"subreddit_type": "user",
"over_18": false
}
}Response Fields
| Field | Type | Notes |
|---|---|---|
name | string | Username |
id | string | Account id without prefix |
fullname | string | t2_ prefixed id, use this when referencing the account in /vote or /dm payloads |
created_utc | number | Account creation, Unix epoch |
created | string | ISO-8601 of created_utc |
link_karma, comment_karma, awardee_karma, awarder_karma, total_karma | number | Karma sub-buckets + total |
is_gold | boolean | Reddit Premium subscriber |
is_mod | boolean | Moderates any subreddit |
is_employee | boolean | Reddit admin/staff |
verified | boolean | Verified account badge |
has_verified_email | boolean | Email confirmed |
accept_followers | boolean | Allows new followers |
icon_img | string | Profile icon URL |
snoovatar_img | string | null | Custom Snoovatar URL (often differs from icon_img); null if not set |
subreddit | object | null | The user's profile sub (u/<name>), see sub-fields |
subreddit.name | string | Subreddit fullname t5_xxxxx |
subreddit.display_name / display_name_prefixed | string | e.g. u_spez / u/spez |
subreddit.title | string | Display name set on the profile |
subreddit.public_description | string | One-line bio |
subreddit.description | string | null | Long-form bio (markdown) |
subreddit.banner_img | string | null | Profile banner URL |
subreddit.subscribers | number | Profile-sub subscriber count |
subreddit.url | string | Path to profile, e.g. /user/spez/ |
subreddit.subreddit_type | string | Usually "user" for profile subs |
subreddit.over_18 | boolean | NSFW profile flag |
Example
curl -H "Authorization: Bearer $TOKEN" \
"https://api.redditapis.com/api/reddit/user/spez"const response = await fetch(
"https://api.redditapis.com/api/reddit/user/spez",
{ headers: { Authorization: "Bearer TOKEN" } }
);import requests
response = requests.get(
"https://api.redditapis.com/api/reddit/user/spez",
headers={"Authorization": "Bearer TOKEN"},
)Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.
Batch Comment Verify
Verify up to 100 Reddit comments in one call. Every id comes back as live, deleted, removed, or not_found, including the ids Reddit itself silently drops.
User Achievements
List the achievements shown on a Reddit user's public achievements page, with the name, description, icons, and grant date of each. Returns an empty list for accounts that have none.