Get a Reddit User Profile and Karma

Fetch a Reddit user's full profile by username — karma sub-buckets, account creation date, employee/gold/verified flags, profile icon, banner, bio, and profile-sub metadata.

GET/api/reddit/user/:name$0.002 / call

User 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)

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.

Get a Reddit User Profile and Karma

Path Parameters

Response (200)

Response Fields

Example

On this page