精准获取指定QQ号的空间全维度信息,包括: 1. 用户基础信息(昵称、头像、星座、空间签名等); 2. 空间数据(说说数量、照片数量、今日/总访问量); 3. VIP信息(VIP等级、成长值等)。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| string | 是 | 需要查询空间信息的QQ号 | 1828222534 |
[
{
"name": "qq",
"type": "string",
"required": true,
"description": "需要查询空间信息的QQ号",
"example": "1828222534"
}
]
{"openapi":"3.1.1","info":{"title":"QQ空间信息","description":"精准获取指定QQ号的空间全维度信息,包括: 1. 用户基础信息(昵称、头像、星座、空间签名等); 2. 空间数据(说说数量、照片数量、今日/总访问量); 3. VIP信息(VIP等级、成长值等)。","version":"1.0.0"},"paths":{"/v1/qzone_info.php":{"get":{"summary":"QQ空间信息","description":"精准获取指定QQ号的空间全维度信息,包括: 1. 用户基础信息(昵称、头像、星座、空间签名等); 2. 空间数据(说说数量、照片数量、今日/总访问量); 3. VIP信息(VIP等级、成长值等)。","parameters":[{"name":"qq","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"需要查询空间信息的QQ号"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"QQ空间信息","description":"精准获取指定QQ号的空间全维度信息,包括: 1. 用户基础信息(昵称、头像、星座、空间签名等); 2. 空间数据(说说数量、照片数量、今日/总访问量); 3. VIP信息(VIP等级、成长值等)。","parameters":[{"name":"qq","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"需要查询空间信息的QQ号"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"data": {
"user_info": {
"qq": "1828222534",
"name": "慕名",
"head_url": "http://q2.qlogo.cn/headimg_dl?dst_uin=1828222534&spec=640",
"qzone_name": "欢迎来到慕名的空间",
"gender": "未知",
"age": 0,
"constellation": "白羊座",
"qzone_desc": "忧心人🚶"
},
"qzone_info": {
"pic_count": 0,
"shuoshuo_count": 31,
"visitor_today_count": 0,
"visitor_all_count": 373258
},
"vip_info": {
"isVip": 0,
"level": 1,
"vip_score": 0,
"vip_speed": 0,
"vip_ratio": 0
}
},
"time": "2026年2月3日 14:28:12",
"tips": "慕名API:http://xiaoapi.cn"
}
该接口提供指定QQ号码的QQ空间全维度信息查询服务,返回内容包括用户基础资料、空间动态数据及会员等级信息,适用于社交数据分析或用户信息聚合场景。
/v1/qzone_info.php
GET、POST
无需密钥
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 需要查询空间信息的QQ号 |
qq:目标QQ号码,格式为纯数字字符串,如 1828222534{
"code": 200,
"data": {
"user_info": {
"qq": "1828222534",
"name": "慕名",
"head_url": "http://q2.qlogo.cn/headimg_dl?dst_uin=1828222534&spec=640",
"qzone_name": "欢迎来到慕名的空间",
"gender": "未知",
"age": 0,
"constellation": "白羊座",
"qzone_desc": "忧心人"
},
"qzone_info": {
"pic_count": 0,
"shuoshuo_count": 31,
"visitor_today_count": 0,
"visitor_all_count": 373258
},
"vip_info": {
"isVip": 0,
"level": 1,
"vip_score": 0,
"vip_speed": 0,
"vip_ratio": 0
}
},
"time": "2026年2月3日 14:28:12",
"tips": "慕名API:http://xiaoapi.cn"
}
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200表示成功 |
| time | string | 服务器响应时间 |
| tips | string | 提示信息 |
| data | object | 包含用户空间信息的对象 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| string | QQ号码 | |
| name | string | 用户昵称 |
| head_url | string | 头像完整URL地址 |
| qzone_name | string | 空间名称/标题 |
| gender | string | 性别(男/女/未知) |
| age | int | 年龄 |
| constellation | string | 星座 |
| qzone_desc | string | 空间个性签名 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| pic_count | int | 相册照片数量 |
| shuoshuo_count | int | 说说总数 |
| visitor_today_count | int | 今日访问量 |
| visitor_all_count | int | 空间总访问量 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| isVip | int | 是否为VIP会员(0否/1是) |
| level | int | VIP等级 |
| vip_score | int | 会员成长值 |
| vip_speed | int | 成长速度 |
| vip_ratio | int | 成长比例 |
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}
{
"code": 0,
"msg": "接口维护中",
"errcode": 11006
}
| 错误码 | 说明 |
|---|---|
| 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 -X GET "https://api.xiaoapi.cn/v1/qzone_info.php?qq=1828222534"
// PHP
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.xiaoapi.cn/v1/qzone_info.php?qq=1828222534");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
隐私设置影响:目标QQ号的QQ空间若设置了访问权限或已注销,部分字段可能返回空值或默认值(如昵称、头像、访问量等),建议调用前确认目标空间可正常访问。
查询频率:虽为免费接口,仍建议控制请求频率,避免短时间内大量调用导致IP被限流。
HTTPS 建议:生产环境建议通过 HTTPS 协议调用本接口,以确保数据传输安全。
参数校验:请在请求前对 qq 参数格式进行初步校验(纯数字、5-11位),避免因格式错误产生无效请求。
数据时效性:空间访问量、说说数量等动态数据可能存在一定延迟,结果仅供参考,不作为实时数据依据。
错误处理:若返回 code 非 200,请根据返回的 tips 提示或自行定义的状态码进行对应错误处理。
curl "http://xiaoapi.cn/v1/qzone_info.php?qq=1828222534"
// 结果将在此处显示