Fetch Reddit User Profile & Karma Breakdown

GET/v1/users/profile

Query Parameters

usernamestringrequired

Example Request (cURL / Python / JavaScript)

curl "https://api.forumdataapi.com/v1/users/profile?username=" \
  -H "x-api-key: rd_live_your_api_key"

import requests

res = requests.get(
    "https://api.forumdataapi.com/v1/users/profile?username=",
    headers={"x-api-key": "rd_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.forumdataapi.com/v1/users/profile?username=", {
  headers: { "x-api-key": "rd_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://forumdataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "username": "spez",
    "display_name": "spez",
    "user_id": "t2_1w72",
    "link_karma": 164200,
    "comment_karma": 785400,
    "total_karma": 949600,
    "is_gold": true,
    "is_mod": true,
    "is_verified": true,
    "has_verified_email": true,
    "over_18": false,
    "icon_img": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_1.png",
    "bio": "CEO at Reddit.",
    "created_utc": 1118016000,
    "created_at": "2005-06-06T00:00:00.000Z"
  },
  "meta": {
    "request_id": "a34d2f10-81e3-4c22-9118-092f1a8b9900",
    "endpoint": "/v1/users/profile",
    "credits_used": 2,
    "credits_remaining": 249990,
    "cache_hit": true,
    "data_age_seconds": 24,
    "latency_ms": 12
  }
}

Response Fields

Reddit user profile metadata (2 Credits)

Field	Type	Sample / Notes
`code`	integer	Example: 0
`status`	string	Example: ok
`data`	RedditUser
`meta`	ResponseMeta
`request_id`	string	UUID v4 request identifier
`endpoint`	string	Canonical /v1/* endpoint path
`credits_used`	integer	Credits deducted for this call (0 on error or empty)
`credits_remaining`	integer	Remaining credit balance on account
`cache_hit`	boolean	Whether served from L1 Redis cache
`data_age_seconds`	integer	Age of cached payload in seconds
`latency_ms`	integer	End-to-end gateway latency in milliseconds

Status Codes

200: Reddit user profile metadata (2 Credits)
401: Missing or invalid x-api-key (0 Credits charged)
402: Insufficient credit balance — includes topup_url and credits_remaining (0 Credits charged)
404: Subreddit, post, or user not found / private / banned (0 Credits charged)
429: Plan RPM or concurrency limit exceeded (0 Credits charged)
502: Upstream temporarily unavailable (0 Credits charged)