QQ资料查询
查询QQ用户个人资料、QQ群信息及达人天数等数据。适用于需要获取QQ基础信息和社交属性的业务场景。
接口信息
GET / POST
api.vsaa.cn/api/qq/info.php
Method
GET / POST
分类
工具
Calls
10
KEY
KEY 必填
计费
1 积分 / 次
QPM
60/MIN
鉴权方式
Query 参数、Header(X-API-Key)、Bearer Token
作者
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| action | string | 是 | 操作方法 | uin.profile |
| uin | string | 否 | QQ号码 | 603212202 |
| group_id | string | 否 | QQ群号码 | 288305439 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "action",
"type": "string",
"required": true,
"description": "操作方法",
"example": "uin.profile"
},
{
"name": "uin",
"type": "string",
"required": false,
"description": "QQ号码",
"example": "603212202"
},
{
"name": "group_id",
"type": "string",
"required": false,
"description": "QQ群号码",
"example": "288305439"
}
]
返回示例
{
"code": 200,
"msg": "查询成功",
"data": {
"uid": "u_N2pU0lTXFWR_mPtJg3KR6Q",
"uin": "603212202",
"nick": "简",
"remark": "无边落木萧萧下",
"constellation": 0,
"shengXiao": 6,
"kBloodType": 0,
"homeTown": "0-0-0",
"makeFriendCareer": 0,
"pos": "",
"college": "",
"country": "",
"province": "",
"city": "",
"postCode": "",
"address": "",
"regTime": 1577889888,
"interest": "",
"labels": [],
"qqLevel": 56,
"qid": "XcwlCandy",
"longNick": "和光同尘，生生不息。",
"birthday_year": 0,
"birthday_month": 0,
"birthday_day": 0,
"age": 0,
"sex": "unknown",
"eMail": "",
"phoneNum": "166******89",
"categoryId": 0,
"richTime": 1778236989,
"richBuffer": [3, 30, 229, 146, 140, 229, 133, 137, 229, 144, 140, 229, 176, 152, 239, 188, 140, 231, 148, 159, 231, 148, 159, 228, 184, 141, 230, 129, 175, 227, 128, 130, 144, 33, 54, 48, 51, 50, 49, 50, 50, 48, 50, 54, 57, 102, 100, 98, 101, 51, 100, 55, 101, 99, 102, 97, 101, 49, 101, 48, 51, 101, 98, 53, 56, 97, 48],
"topTime": "0",
"isBlock": false,
"isMsgDisturb": false,
"isSpecialCareOpen": false,
"isSpecialCareZone": false,
"ringId": "",
"isBlocked": false,
"recommendImgFlag": 1,
"disableEmojiShortCuts": 0,
"qidianMasterFlag": 0,
"qidianCrewFlag": 0,
"qidianCrewFlag2": 0,
"isHideQQLevel": 0,
"isHidePrivilegeIcon": 1,
"isHideSession": false,
"c2cRingId": "",
"notifyFlag": [],
"wxMsgNotifyClosed": false,
"aiAuthMsgBlacklistTimeS": 0,
"aiAuthQZoneBlacklistTimeS": 0,
"status": 20,
"extStatus": 0,
"batteryStatus": 0,
"termType": 0,
"netType": 0,
"iconType": 0,
"customStatus": null,
"setTime": "0",
"specialFlag": 0,
"abiFlag": 0,
"eNetworkType": 0,
"showName": "",
"termDesc": "",
"musicInfo": {
"buf": []
},
"extOnlineBusinessInfo": {
"buf": [],
"customStatus": null,
"videoBizInfo": {
"cid": "",
"tvUrl": "",
"synchType": ""
},
"videoInfo": {
"name": ""
}
},
"extBuffer": {
"buf": []
},
"customStatusDescInfo": null,
"user_id": 603212202,
"nickname": "简",
"long_nick": "和光同尘，生生不息。",
"reg_time": 1577889888,
"is_vip": false,
"is_years_vip": false,
"vip_level": 5,
"login_days": 0
},
"tips": "Vsaa Api 3.0"
}
详细文档
QQ资料查询
接口说明
查询QQ用户个人资料、QQ群信息及达人天数等数据。适用于需要获取QQ基础信息和社交属性的业务场景。接口支持通过Query参数传递密钥进行鉴权调用。
调用地址
/api/qq/info.php
请求方式
GET / POST
鉴权说明
本接口必须提供接口密钥方可调用。
密钥传递方式：Query 参数 key=您的密钥。
请求示例：/api/qq/info.php?key=您的密钥&action=uin.profile&uin=603212202
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥 |
| action | string | 是 | 操作方法 |
| uin | string | 否 | QQ 号码，如 603212202 |
| group_id | string | 否 | QQ 群号码，如 288305439 |
action 参数取值说明：
| action 值 | 说明 |
|---|---|
| uin.profile | 查询 QQ 个人资料 |
| group.profile | 查询 QQ 群资料 |
| uin.days | 查询 QQ 达人天数 |
注：部分 action 需对应传入
uin或group_id，具体以接口文档为准。
成功响应示例
{
"code": 200,
"msg": "查询成功",
"data": {
"uin": "603212202",
"nick": "简",
"longNick": "和光同尘，生生不息。",
"qqLevel": 56,
"vip_level": 5,
"is_vip": false,
"age": 0,
"sex": "unknown",
"regTime": 1577889888,
"login_days": 0,
"uid": "u_N2pU0lTXFWR_mPtJg3KR6Q",
"qid": "XcwlCandy",
"status": 20,
"eMail": "",
"phoneNum": "166******89",
"homeTown": "0-0-0",
"country": "",
"province": "",
"city": "",
"postCode": "",
"address": "",
"college": "",
"pos": "",
"interest": "",
"labels": [],
"user_id": 603212202,
"nickname": "简",
"long_nick": "和光同尘，生生不息。",
"reg_time": 1577889888
},
"tips": "Vsaa Api 3.0"
}响应字段说明
基础信息
| 字段 | 类型 | 说明 |
|---|---|---|
| uin | string | QQ号码 |
| nick | string | 昵称 |
| longNick | string | 长昵称/签名 |
| qqLevel | number | QQ等级 |
| vip_level | number | VIP等级 |
| is_vip | boolean | 是否VIP用户 |
| regTime | number | 注册时间戳 |
| login_days | number | 累计登录天数 |
| age | number | 年龄 |
| sex | string | 性别 |
联系方式
| 字段 | 类型 | 说明 |
|---|---|---|
| string | 邮箱 | |
| phoneNum | string | 手机号（脱敏显示） |
位置信息
| 字段 | 类型 | 说明 |
|---|---|---|
| homeTown | string | 家乡地址 |
| country | string | 国家 |
| province | string | 省份 |
| city | string | 城市 |
| postCode | string | 邮编 |
| address | string | 详细地址 |
| college | string | 毕业院校 |
| pos | string | 职位 |
状态与标识
| 字段 | 类型 | 说明 |
|---|---|---|
| status | number | 在线状态 |
| uid | string | 用户唯一标识 |
| qid | string | QQ ID别名 |
| user_id | number | 数字型用户ID |
| nickname | string | 昵称（别名字段） |
| long_nick | string | 长昵称（别名字段） |
| reg_time | number | 注册时间戳（别名字段） |
| is_vip | boolean | 是否VIP（别名字段） |
| is_years_vip | boolean | 是否年费VIP |
错误响应示例
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}业务错误码说明
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁（QPM 限制） |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
调用示例
终端 curl（bash）
查询 QQ 个人资料：
curl "https://api.example.com/api/qq/info.php?key=YOUR_KEY&action=uin.profile&uin=603212202"查询 QQ 群资料：
curl "https://api.example.com/api/qq/info.php?key=YOUR_KEY&action=group.info&group_id=288305439"PHP
// PHP
$key = "YOUR_KEY";
$action = "uin.profile";
$uin = "603212202";
$url = "https://api.example.com/api/qq/info.php?key=" . urlencode($key) . "&action=" . urlencode($action) . "&uin=" . urlencode($uin);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
if ($result && $result["code"] == 200) {
echo "昵称：" . $result["data"]["nick"] . "\n";
echo "等级：" . $result["data"]["qqLevel"] . "\n";
echo "注册日期：" . date("Y-m-d", $result["data"]["regTime"]);
} else {
echo "查询失败：" . ($result["msg"] ?? "未知错误");
}注意事项
- 密钥参数通过 Query 字符串传递，请勿将完整接口地址及密钥硬编码至前端代码或公开仓库，避免被恶意调用产生额外费用。
- 建议全站启用 HTTPS，防止请求参数在传输过程中被截获。
- 接口按分钟维度进行频率限制，上限约为 60 次/分钟，超出后请求将被拒绝，请合理控制调用节奏。
uin与group_id为可选参数，实际返回内容取决于action取值，调用前请确认所需参数组合。- 返回数据中的
phoneNum字段已做脱敏处理，仅展示部分位数，不可用于直接联系目标用户。 - 接口为收费服务，频繁无效查询或异常参数调用可能产生不必要的费用，建议在业务层做好参数校验与日志记录。
regTime、richTime等时间戳字段为 Unix 秒级整数，使用前请按需转换为可读日期格式。longNick与nick字段可能为空或内容特殊，渲染时建议做长度截断与 XSS 过滤。is_vip、vip_level等字段反映用户 VIP 状态，但字段值为 0 或 false 不代表无特权，请以实际业务逻辑为准。- 本接口仅提供公开资料查询能力，不支持对私密信息、聊天记录、好友列表等敏感数据的访问。
快速上手
暂无代码示例。管理员可在后台用 AI 生成或手动编写。
在线测试
请求地址
api.vsaa.cn/api/qq/info.php
Method
参数
Response
等待中
// 结果将在此处显示