UapiProUApiPro
Social

Query QQ User Info

0calls
4 credits / call

Look up a QQ user's profile by QQ number. Returns avatar, nickname, signature, level, and VIP information.

GET
uapis.cn
/api/v1/social/qq/userinfo
Query parameters
1
qq
string
required

QQ number to look up.

Overview

This endpoint is well suited for user-profile rendering, avatar cards, and account-binding result screens. When the user has hidden their QQ level, qq_level returns null.

Note

reg_time is the account's original official registration time. Some early or special QQ accounts may return earlier timestamps (e.g., 1999-01-01 or 2001-01-01), depending on the account's own history.

Query parameters

qq
stringrequired

QQ number to look up.

Response

200 / OK

Success. Returns detailed QQ user information.

JSON
{
  // QQ number.
  "qq": "10001",
  // User nickname.
  "nickname": "Sample User",
  // Signature.
  "long_nick": "Sample status text.",
  // Avatar URL.
  "avatar_url": "http://q.qlogo.cn/g?b=qq&nk=10001&s=640",
  // Age.
  "age": 25,
  // Gender.
  "sex": "male",
  // QQ personalized QID domain.
  "qid": "xiaoming2024",
  // QQ level. Returns null when hidden by the user.
  "qq_level": 64,
  // Geographic location (province + city).
  "location": "Guangdong Shenzhen",
  // QQ email address.
  "email": "10001@qq.com",
  // Whether the user is a VIP.
  "is_vip": true,
  // Whether the user has annual VIP.
  "is_years_vip": true,
  // Whether the user is an SVIP.
  "is_svip": true,
  // Whether the user has QQ Big Club membership.
  "is_big_club": true,
  // VIP activation status.
  "vip_status": 1,
  // VIP type.
  "vip_type": 3,
  // VIP level.
  "vip_level": 7,
  // QQ Big Club level.
  "big_club_level": 1,
  // Yellow Diamond level, when available.
  "yellow_diamond_level": 10,
  // Green Diamond level, when available.
  "green_diamond_level": 9,
  // Tencent Video VIP level, when available. No extra parameter is required; this field is omitted when upstream does not return it or the level is 0.
  "video_vip_level": 7,
  // Lover privilege level, when available.
  "lover_vip_level": 2,
  // Selected privilege icon states.
  "privilege_icons": {
    // Whether the VIP icon is active.
    "vip": true,
    // Whether the SVIP icon is active.
    "svip": true,
    // Whether the annual VIP icon is active.
    "years_vip": true,
    // Whether the QQ Big Club icon is active.
    "big_club": true
  },
  // QQ registration time (ISO 8601 format).
  "reg_time": "2008-03-15T10:30:00+08:00",
  // Last-updated time (ISO 8601 format).
  "last_updated": "2024-08-14T15:45:30Z"
}

400 / Bad Request

Missing or invalid qq parameter.

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing or invalid 'qq' parameter."
}

404 / Not Found

Failed to fetch QQ user info, or the user does not exist.

JSON
{
  "code": "NOT_FOUND",
  "details": {},
  "message": "Failed to retrieve QQ user info, user may not exist."
}
PreviousQuery Bilibili User
NextQuery Bilibili Archives