/ 接口详情
/ 接口详情
·
网络工具
GET / POST
QQ等级查询
获取 QQ 账号的全维度等级信息，包含 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长，以及 QQ 会员（等级、年标、成长值、到期时间、图标）、QQ 音乐绿钻（绿钻等级、年标状态、成长值）等核心权益信息。
调用 334,502 次
0.5 积分 / 次
KEY 必填
QPM 60/MIN
Query 参数、Header(X-API-Key)、Bearer Token
接口信息
GET / POST
xiaoapi.cn/v1/qq_level.php
方法
GET / POST
分类
网络工具
计费
0.5 积分 / 次
KEY
KEY 必填
调用
334,502
QPM
60/MIN
鉴权
Query 参数、Header(X-API-Key)、Bearer Token
作者
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| string | 是 | 需要查询的QQ号，如：1828222534 | 1828222534 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "qq",
"type": "string",
"required": true,
"description": "需要查询的QQ号，如：1828222534",
"example": "1828222534"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "QQ等级查询",
"description": "获取 QQ 账号的全维度等级信息，包含 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长，以及 QQ 会员（等级、年标、成长值、到期时间、图标）、QQ 音乐绿钻（绿钻等级、年标状态、成长值）等核心权益信息。",
"version": "1.0.0"
},
"paths": {
"/v1/qq_level.php": {
"get": {
"summary": "QQ等级查询",
"description": "获取 QQ 账号的全维度等级信息，包含 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长，以及 QQ 会员（等级、年标、成长值、到期时间、图标）、QQ 音乐绿钻（绿钻等级、年标状态、成长值）等核心权益信息。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "qq",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "1828222534"
},
"description": "需要查询的QQ号，如：1828222534"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "QQ等级查询",
"description": "获取 QQ 账号的全维度等级信息，包含 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长，以及 QQ 会员（等级、年标、成长值、到期时间、图标）、QQ 音乐绿钻（绿钻等级、年标状态、成长值）等核心权益信息。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "qq",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "1828222534"
},
"description": "需要查询的QQ号，如：1828222534"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https://xiaoapi.cn",
"description": "当前访问入口（https）"
}
]
}
返回示例
{
"code": 200,
"qq": "3414871787",
"qid": "subaiya",
"name": "rm -rf /苏白呀",
"avatar": "http://qh.qlogo.cn/g?b=sdk&ek=AQI6EwbD6rbLcAv1zY0yiakMrnW4QxGTWVuCEBeLED7HTGz7lZz0iaNKKRp3iczCVMX7WT92icn5M4lg5mJQGXiaNm8otTzcnQcp7nLlCvUicreVic3ib5JcQH0&s=100&t=1768406487",
"level": "128级",
"ico": "👑👑",
"iNextLevelDay": "4天",
"iTotalActiveDay": "17153天",
"pc_online": 0.8,
"vip": {
"year": "是",
"level": "10",
"value": 123537,
"ico": "https://imgcache.qq.com/vipstyle/component/img/nameplate/svip/lv/year-svip10-l1-on.png?max_age=2592000",
"expire": "2029-03-24 19:44:07"
},
"music_vip": {
"isyear": 0,
"level": 6,
"vip": 1,
"score": 31021
},
"tips": "慕名API：http://xiaoapi.cn"
}
详细文档
QQ等级查询
接口说明
提供 QQ 账号的全维度等级信息查询，包括 QQ 等级、总活跃天数、升级剩余天数、PC 端在线时长，以及 QQ 会员、QQ 音乐绿钻等核心权益状态。适用于需要查询好友或自身 QQ 账号等级与权益场景。
调用地址
/v1/qq_level.php
请求方式
GET、POST
鉴权说明
无需密钥。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 需要查询的QQ号 |
参数取值说明
- 传入格式：纯数字字符串，如
1828222534 - QQ号长度：5-11 位数字
- 无需进行任何签名或鉴权操作
成功响应示例
{
"code": 0,
"msg": "success",
"data": {
"qq": "1828222534",
"level": 48,
"total_active_days": 2190,
"remaining_days": 45,
"pc_online_hours": 156,
"vip": {
"is_vip": true,
"level": 6,
"annual": true,
"growth_value": 15800,
"expire_time": "2025-08-15"
},
"green_vip": {
"is_green_vip": true,
"level": 8,
"annual": false,
"growth_value": 8200
}
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，0 表示成功 |
| msg | string | 状态描述信息 |
| data | object | 查询结果数据对象 |
| data.qq | string | 查询的 QQ 号 |
| data.level | int | QQ 等级 |
| data.total_active_days | int | 总活跃天数 |
| data.remaining_days | int | 距离下一等级剩余天数 |
| data.pc_online_hours | int | PC 端累计在线时长（小时） |
| data.vip | object | QQ 会员信息 |
| data.vip.is_vip | bool | 是否为 QQ 会员 |
| data.vip.level | int | QQ 会员等级 |
| data.vip.annual | bool | 是否为年费会员 |
| data.vip.growth_value | int | 会员成长值 |
| data.vip.expire_time | string | 会员到期时间（YYYY-MM-DD 格式） |
| data.green_vip | object | QQ 音乐绿钻信息 |
| data.green_vip.is_green_vip | bool | 是否为绿钻会员 |
| data.green_vip.level | int | 绿钻等级 |
| data.green_vip.annual | bool | 是否为年费绿钻 |
| data.green_vip.growth_value | int | 绿钻成长值 |
错误响应示例
当请求处理失败时，接口返回统一格式的错误响应。以下为典型的错误响应示例：
{"code":0,"msg":"请求过于频繁，请稍后再试","errcode":11005}业务错误码说明
本接口采用统一的错误码体系，所有错误响应均包含 code、msg 和 errcode 字段。errcode 为数值型错误代码，msg 为对应的中文描述。
| 错误码 | 说明 |
|---|---|
| 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）
curl -X POST "https://api.example.com/v1/qq_level.php" \
-d "qq=1828222534"PHP
// 初始化请求
$ch = curl_init();
// 设置请求参数
$url = "https://api.example.com/v1/qq_level.php";
$params = ["qq" => "1828222534"];
// POST 请求
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 发送请求并获取响应
$response = curl_exec($ch);
// 解析返回数据
$result = json_decode($response, true);
// 输出结果
print_r($result);
// 关闭连接
curl_close($ch);注意事项
- 请求方式：支持 GET 与 POST 两种方式提交查询请求。
- 参数格式：仅需传入
qq参数，值为待查询的 QQ 号，建议使用纯数字字符串格式，避免携带空格或特殊字符。 - 号码有效性：接口不会校验 QQ 号是否存在，若传入格式异常或为空，可能返回错误响应。
- 查询频率：尽管本接口免费，但仍建议控制调用频率，避免短时间内大量请求影响响应效率。
- 返回数据：返回结果包含 QQ 等级、总活跃天数、会员等级、QQ 音乐绿钻等多维度信息，具体字段以实际返回为准。
- 接口计费：本接口完全免费，无需支付任何费用即可调用。
- 安全提示：本接口无需任何鉴权信息，请勿将类似接口地址在不受信任的环境中随意传播。
快速上手
curl "http://xiaoapi.cn/v1/qq_level.php?qq=1828222534"在线测试
请求地址
xiaoapi.cn/v1/qq_level.php
Method
参数
Response
// 结果将在此处显示
接口反馈
推荐接口
服务免责声明
生效日期：2026年7月22日
欢迎使用 xiaoapi.cn（以下简称"本平台"）。在使用本平台提供的 API 服务（以下简称"本服务"）前，请务必仔细阅读并充分理解本免责声明。您以任何方式调用、访问或使用本服务，即视为您已阅读、理解并同意接受本声明的全部内容。
一、声明目的
本平台作为 API 技术服务的提供方，仅提供技术接口与数据分发服务。本声明的目的在于明确平台与用户之间的责任边界，督促用户合法、合规地使用本服务，防范违法违规行为的发生。
二、用户责任与合规承诺
- 用户应为自身的一切调用行为承担全部责任，包括但不限于调用方式、调用目的、数据使用、结果传播及由此产生的全部后果。
- 用户承诺在使用本服务过程中，严格遵守中华人民共和国法律法规以及所在国家/地区的适用法律，包括但不限于《网络安全法》《数据安全法》《个人信息保护法》《著作权法》《刑法》及相关司法解释。
- 用户承诺不以任何方式利用本服务从事损害国家利益、社会公共利益、他人合法权益的活动。
三、禁止性行为
用户在使用本服务时，明确禁止从事以下行为：
- 利用本服务制作、复制、传播、存储任何法律法规禁止的内容，包括但不限于色情低俗、赌博、诈骗、暴力恐怖、毒品、虚假谣言等信息；
- 利用本服务从事黑客攻击、入侵、破坏、干扰、非法获取他人数据或系统权限等行为；
- 利用本服务侵犯他人知识产权、商业秘密、个人隐私或其他合法权益；
- 利用本服务实施网络诈骗、钓鱼、洗钱、电信网络诈骗等违法犯罪活动；
- 绕过本平台或第三方平台的安全机制、访问控制、收费机制或版权保护措施；
- 未经授权将本服务用于商业转售、批量恶意调用、恶意抓取、骚扰性推送等行为；
- 其他违反法律法规或本平台服务协议的行为。
四、第三方内容与数据免责
- 本服务所分发、转发或返回的部分数据、内容可能来源于第三方接口、公开网络或其他合作方，本平台对其真实性、准确性、合法性不作出任何保证。
- 因第三方内容、第三方接口异常、第三方版权纠纷或第三方平台政策变化所引发的任何争议、损失，由相关第三方承担责任，本平台不承担由此产生的责任，但将依法配合权利人和主管部门进行处理。
五、平台免责范围
在法律法规允许的最大范围内，本平台对以下情形不承担责任：
- 用户因违规、违法使用本服务所产生的全部法律责任与后果，均由用户自行承担；
- 因用户操作不当、接口误用、参数错误、网络环境异常等原因造成的损失；
- 因不可抗力（包括但不限于自然灾害、政府行为、电力故障、网络中断、第三方服务故障）导致的服务中断、延迟或数据丢失；
- 因本平台进行必要的系统维护、升级、调整而导致的服务临时不可用；
- 用户之间、用户与第三方之间因使用本服务产生的纠纷。
六、违规处理与账号管理
- 本平台有权对用户的调用行为进行监测与审查。
- 一经发现用户存在违法、违规或违反本声明的行为，本平台有权视情节轻重采取警告、限制调用、暂停服务、封禁账号等措施，并保留向有关主管部门举报、移交司法机关处理的权利。
- 因用户违规行为导致本平台被第三方索赔、被主管部门处罚或遭受其他损失的，用户应承担全部赔偿责任。
七、赔偿条款
因用户违反本声明或相关法律法规，导致本平台及其关联方、合作方遭受任何损失（包括但不限于赔偿款、罚款、律师费、诉讼费等），用户同意向本平台及相关方承担全部赔偿责任。
八、知识产权
- 本平台自身的商标、标识、界面设计、技术代码等知识产权归本平台所有，未经许可不得擅自使用。
- 用户不得利用本服务对第三方知识产权进行侵犯；因用户侵权行为引发的纠纷由用户自行负责。
九、法律适用与争议解决
- 本声明的订立、解释、变更及争议解决均适用中华人民共和国法律。
- 因本声明或本服务产生的争议，双方应友好协商解决；协商不成的，任何一方可向本平台运营方所在地有管辖权的人民法院提起诉讼。
十、声明变更
本平台有权根据法律法规变化、业务调整或监管要求，随时修改本声明。修改后的声明将在本页面公布，自公布之日起生效。您继续使用本服务，即视为接受更新后的声明。
十一、联系我们
如您对本声明有任何疑问，或发现他人存在违规使用本服务的行为，欢迎通过本平台公示的联系方式与我们联系，我们将及时处理。