Reddit User Lookup

Look up a Reddit account by username: account age, total, post and comment karma, avatar, and when available bio and badges (verified, moderator, employee, premium). Costs 1 credit. Tip: set detail=full to always get bio and badges (2 credits); the default may return them as null.

name path, string, required

Reddit username, with or without u/, or a profile URL. 3-20 characters.

detail query, enum

full guarantees bio and badges and costs 2 credits. One of: basic, full. Default basic.

data is one RedditUser. Fields:

{
  "data": {
    "username": "spez",
    "id": "t2_1w72",
    "createdAt": "2005-06-06T04:00:00.000Z",
    "karma": {
      "total": 941002,
      "post": 184509,
      "comment": 756493
    },
    "bio": null,
    "avatarUrl": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png",
    "badges": null
  },
  "credits": {
    "charged": 2,
    "remaining": 24997
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
  "cached": false
}

Recorded live response captured 2026-10-07, truncated to 3 items. Credits and request id are illustrative.

Up to 2 credits per call: 1 credit, 2 with detail=full. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 1 hour are served from cache.

• missing_key
• invalid_key
• key_revoked
• account_suspended
• invalid_input
• insufficient_credits
• rate_limited
• upstream_error
• upstream_timeout
• internal
• not_found