QWQLwToo
3.5 KiB
3.5 KiB
---
title: "查询 QQ 信息"
locale: zh-CN
canonical: https://uapis.cn/docs/api-reference/get-social-qq-userinfo
source: https://uapis.cn/docs/api-reference/get-social-qq-userinfo.md
---
# 查询 QQ 信息
**分类：** 社交
通过 QQ 号查询用户资料，返回头像、昵称、个性签名、等级和 VIP 信息。
## 功能概述
这个接口适合用在用户资料展示、头像卡片、账号绑定结果展示等场景。若用户把 QQ 等级设为隐藏，qq\_level 会返回 null。
## 数据字段说明
- **基础信息**: 昵称、个性签名、头像、年龄、性别
- **联系信息**: QQ 邮箱、个性域名（QID）
- **等级信息**: QQ 等级、VIP 状态和等级
- **时间信息**: 注册时间、最后更新时间
## API 端点
**方法：** GET
**路径：** /social/qq/userinfo
**完整API地址：** https://uapis.cn/api/v1/social/qq/userinfo
**文档页面：** https://uapis.cn/docs/api-reference/get-social-qq-userinfo
## 响应
### 200 / 请求成功
成功响应，返回QQ用户的详细信息
{
  // 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,
  // 腾讯影视会员等级（可选）
  "video\_vip\_level": 7,
  // 情侣/恋人类会员等级（可选）
  "lover\_vip\_level": 2,
  // 部分特权图标状态
  "privilege\_icons": {
  // VIP图标是否点亮
  "vip": true,
  // SVIP图标是否点亮
  "svip": false,
  // 年费VIP图标是否点亮
  "years\_vip": true,
  // QQ大会员图标是否点亮
  "big\_club": true
  },
  // 注册时间（ISO 8601格式）
  "reg\_time": "2008-03-15T10:30:00Z",
  // 最后更新时间（ISO 8601格式）
  "last\_updated": "2024-08-14T15:45:30Z"
}
### 400 / 错误的请求
缺少或无效的qq参数
{
  "code": "INVALID\_ARGUMENT",
  "details": {},
  "message": "Missing or invalid 'qq' parameter."
}
### 404 / 未找到
获取QQ用户信息失败或用户不存在
{
  "code": "NOT\_FOUND",
  "details": {},
  "message": "Failed to retrieve QQ user info, user may not exist."
}
## 查询参数
- **qq** (string) - 必填
需要查询的QQ号
示例：10001
提示：纯数字的QQ号。