QQ 信息

API

通过 QQ 号查询昵称、QQ 邮箱、QQ 空间链接，并生成 4 种尺寸的头像直链 URL（s40/s100/s140/s640）。 • 严格 5-11 位数字校验（防服务字符串截断引起的号码错位） • 安全增强：服务返回的 QQ key 必须与请求严格一致，否则视为未查询到 • …

接入文档

由极数本源提供·更新于今天

先试用，再接接口

不用写代码。打开工具页跑一遍 QQ 账号查询，看清结果再来订阅。

打开QQ 账号查询

9.5万

累计调用

152ms

平均响应

100.00%

服务可用性

30,000 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 3

今日已用 … / 30,000 次/日…

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

每天 5,000 次 · QPS 2

登录免费

当前方案

每天 30,000 次 · QPS 3

黄金会员

每天 50,000 次 · QPS 10

钻石会员

每天 100,000 次 · QPS 30

企业会员

每天 1,000,000 次 · QPS 120

AI 文档

把这个地址发给 AI，就能生成调用代码

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 小时）不计入服务配额。

请求参数说明

qq（QQ 号）string

必填 · 5-11 位 QQ 号码（纯数字） · 示例：88888888

名称	类型	说明
qq（QQ 号）	string	必填 · 5-11 位 QQ 号码（纯数字） · 示例：88888888

请求头说明

Authorizationstring

可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

名称	类型	说明
Authorization	string	可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

返回字段说明

qqstring

查询的 QQ 号（原样回传）

namestring

QQ 昵称；用户未设置或腾讯未开放时为空字符串

mailstring

QQ 邮箱地址（qq + @qq.com 拼接，未验证开通状态）

qzonestring

QQ 空间个人主页 URL

avatarsobject

多尺寸头像直链对象

s40string

40×40 头像直链 URL（小图标）

s100string

100×100 头像直链 URL（列表用）

s140string

140×140 头像直链 URL（中等）

s640string

640×640 头像直链 URL（高清，原图）

is_foundboolean

是否查询到该 QQ：true=找到 / false=号码不存在或已注销

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

名称

类型

说明

string

查询的 QQ 号（原样回传）

name

string

QQ 昵称；用户未设置或腾讯未开放时为空字符串

mail

string

QQ 邮箱地址（qq + @qq.com 拼接，未验证开通状态）

qzone

string

QQ 空间个人主页 URL

avatars

object

多尺寸头像直链对象

s40	string	40×40 头像直链 URL（小图标）
s100	string	100×100 头像直链 URL（列表用）
s140	string	140×140 头像直链 URL（中等）
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。请勿用于批量爬取或骚扰用途。

加载接口文档…

名称

类型

说明

qq（QQ 号）

string

必填 · 5-11 位 QQ 号码（纯数字） · 示例：88888888

名称

类型

说明

Authorization

string

{ "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" }