\---

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用户的详细信息



```json

{

&#x20; // QQ号

&#x20; "qq": "10001",

&#x20; // 用户昵称

&#x20; "nickname": "小明",

&#x20; // 个性签名

&#x20; "long\_nick": "今天天气真不错",

&#x20; // 头像URL

&#x20; "avatar\_url": "http://q.qlogo.cn/g?b=qq\&nk=10001\&s=640",

&#x20; // 年龄

&#x20; "age": 25,

&#x20; // 性别

&#x20; "sex": "男",

&#x20; // QQ个性域名

&#x20; "qid": "xiaoming2024",

&#x20; // QQ等级。用户隐藏时返回 null

&#x20; "qq\_level": 64,

&#x20; // 地理位置（省市）

&#x20; "location": "广东 深圳",

&#x20; // QQ邮箱

&#x20; "email": "10001@qq.com",

&#x20; // 是否为VIP用户

&#x20; "is\_vip": true,

&#x20; // 是否为年费VIP用户

&#x20; "is\_years\_vip": true,

&#x20; // 是否为SVIP用户

&#x20; "is\_svip": false,

&#x20; // 是否为QQ大会员用户

&#x20; "is\_big\_club": true,

&#x20; // 会员开通状态

&#x20; "vip\_status": 1,

&#x20; // 会员类型

&#x20; "vip\_type": 3,

&#x20; // VIP等级

&#x20; "vip\_level": 7,

&#x20; // QQ大会员等级

&#x20; "big\_club\_level": 1,

&#x20; // 黄钻等级（可选）

&#x20; "yellow\_diamond\_level": 10,

&#x20; // 绿钻等级（可选）

&#x20; "green\_diamond\_level": 9,

&#x20; // 腾讯影视会员等级（可选）

&#x20; "video\_vip\_level": 7,

&#x20; // 情侣/恋人类会员等级（可选）

&#x20; "lover\_vip\_level": 2,

&#x20; // 部分特权图标状态

&#x20; "privilege\_icons": {

&#x20;   // VIP图标是否点亮

&#x20;   "vip": true,

&#x20;   // SVIP图标是否点亮

&#x20;   "svip": false,

&#x20;   // 年费VIP图标是否点亮

&#x20;   "years\_vip": true,

&#x20;   // QQ大会员图标是否点亮

&#x20;   "big\_club": true

&#x20; },

&#x20; // 注册时间（ISO 8601格式）

&#x20; "reg\_time": "2008-03-15T10:30:00Z",

&#x20; // 最后更新时间（ISO 8601格式）

&#x20; "last\_updated": "2024-08-14T15:45:30Z"

}

```



\### 400 / 错误的请求



缺少或无效的qq参数



```json

{

&#x20; "code": "INVALID\_ARGUMENT",

&#x20; "details": {},

&#x20; "message": "Missing or invalid 'qq' parameter."

}

```



\### 404 / 未找到



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



```json

{

&#x20; "code": "NOT\_FOUND",

&#x20; "details": {},

&#x20; "message": "Failed to retrieve QQ user info, user may not exist."

}

```



\## 查询参数



\- \*\*`qq`\*\* (string) - 必填

&#x20; 需要查询的QQ号

&#x20; 示例：`10001`

&#x20; 提示：纯数字的QQ号。

