社交

查询 QQ 信息

0次调用
4 积分/次

通过 QQ 号查询用户资料,返回头像、昵称、个性签名、等级等公开信息。

GET
uapis.cn
/api/v1/social/qq/userinfo
查询参数
1
qq
string
required

需要查询的QQ号

功能概述

这个接口适合用在用户资料展示、头像卡片、账号绑定结果展示等场景。若用户把 QQ 等级设为隐藏,qq_level 会返回 null

小贴士

reg_time 为账号的官方原始注册时间。部分早期或特殊 QQ 账号返回的时间戳可能较早(如 1999-01-01 或 2001-01-01),取决于账号自身的历史记录。

查询参数

qq
string必填

需要查询的QQ号

响应

200 / 请求成功

成功响应,返回QQ用户的详细信息

JSON
{
  // QQ号
  "qq": "10001",
  // 用户昵称
  "nickname": "小明",
  // 个性签名
  "long_nick": "今天天气真不错",
  // 头像URL
  "avatar_url": "http://q.qlogo.cn/g?b=qq&nk=10001&s=640",
  // 年龄
  "age": 25,
  // 性别
  "sex": "男",
  // QQ个性域名
  "qid": "xiaoming2024",
  // QQ等级。用户隐藏时返回 null
  "qq_level": 64,
  // 地理位置(省市)
  "location": "广东 深圳",
  // QQ邮箱
  "email": "10001@qq.com",
  // 是否为VIP用户
  "is_vip": true,
  // 是否为年费VIP用户
  "is_years_vip": true,
  // 是否为SVIP用户
  "is_svip": false,
  // 是否为QQ大会员用户
  "is_big_club": true,
  // 会员开通状态
  "vip_status": 1,
  // 会员类型
  "vip_type": 3,
  // VIP等级
  "vip_level": 7,
  // QQ大会员等级
  "big_club_level": 1,
  // 黄钻等级(可选)
  "yellow_diamond_level": 10,
  // 绿钻等级(可选)
  "green_diamond_level": 9,
  // 腾讯影视会员等级(可选)。不需要额外传参;当上游未返回或等级为 0 时,该字段会省略
  "video_vip_level": 7,
  // 情侣/恋人类会员等级(可选)
  "lover_vip_level": 2,
  // 部分特权图标状态
  "privilege_icons": {
    // VIP图标是否点亮
    "vip": true,
    // SVIP图标是否点亮
    "svip": false,
    // 年费VIP图标是否点亮
    "years_vip": true,
    // QQ大会员图标是否点亮
    "big_club": true
  },
  // QQ 注册时间(ISO 8601 格式)
  "reg_time": "2008-03-15T10:30:00+08:00",
  // 最后更新时间(ISO 8601格式)
  "last_updated": "2024-08-14T15:45:30Z"
}

400 / 错误的请求

缺少或无效的qq参数

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

404 / 未找到

获取QQ用户信息失败或用户不存在

JSON
{
  "code": "NOT_FOUND",
  "details": {},
  "message": "Failed to retrieve QQ user info, user may not exist."
}
QQ用户信息查询API - 头像/昵称/等级一键获取 | UAPI免费API平台 | UAPI