加载接口文档…
4.7万
累计调用
165ms
平均响应
100.00%
服务可用性
30,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 5,000 次 · QPS 3
登录免费
当前方案每日 30,000 次 · QPS 10
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/qq/raw.md接口请求地址
https://v1.apizero.cn/api/qq
接口请求方式
GET
请求参数格式
QUERY STRING
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/qq?qq=88888888
接口信息备注
匿名每日 50 次、QPS 3；登录用户每日 300 次、QPS 10（全部免费）。命中缓存（6 小时）不计入服务配额。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| string | 必填 · 5-11 位 QQ 号码（纯数字） · 示例：88888888 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| string | 查询的 QQ 号（原样回传） | |
| name | string | QQ 昵称；用户未设置或腾讯未开放时为空字符串 |
| string | QQ 邮箱地址（qq + @qq.com 拼接，未验证开通状态） | |
| qzone | string | QQ 空间个人主页 URL |
| avatars | object | 多尺寸头像直链对象 |
| avatars.s40 | string | 40×40 头像直链 URL（小图标） |
| avatars.s100 | string | 100×100 头像直链 URL（列表用） |
| avatars.s140 | string | 140×140 头像直链 URL（中等） |
| avatars.s640 | string | 640×640 头像直链 URL（高清，原图） |
| is_found | boolean | 是否查询到该 QQ：true=找到 / false=号码不存在或已注销 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"qq": "88888888",
"name": "腾讯客服",
"mail": "88888888@qq.com",
"qzone": "https://user.qzone.qq.com/88888888",
"avatars": {
"s40": "https://q1.qlogo.cn/g?b=qq&nk=88888888&s=40",
"s100": "https://q1.qlogo.cn/g?b=qq&nk=88888888&s=100",
"s140": "https://q1.qlogo.cn/g?b=qq&nk=88888888&s=140",
"s640": "https://q1.qlogo.cn/g?b=qq&nk=88888888&s=640"
},
"is_found": true
},
"request_id": "abc123def456",
"tips": "极数本源 · https://apizero.cn"
}免责声明
本接口数据来自腾讯 QQ 公开接口（cgi_get_portrait.fcg），仅返回用户自主公开的昵称、头像与 QQ 邮箱后缀。腾讯接口未承诺 SLA，部分账号可能因隐私设置或销号而返回 is_found=false。请勿用于批量爬取或骚扰用途。