前言

现在市面上的根据 QQ 号获取 QQ 昵称、信息之类的接口基本上都死完了，还有一个官方的活着，但是有些昵称也不获取不到，是乱码，而且不稳定，经常失效。

接口地址: https://users.qzone.qq.com/fcg-bin/cgi_get_portrait.fcg?uins=10001

今天搭建了一个自己的，顺便把 twikoo 的评论获取QQ昵称修复一下。 已修复。

2026-05-13 切换接口至: https://r.qzone.qq.com/fcg-bin/cgi_get_portrait.fcg?g_tk=[bkn]&uins=[qq_num]

接口详情

接口每个账号数据缓存 30 天

接口地址：https://api.ncii.cn/qq/?qq=qq_num&token=token

返回值如下：

{
  "success": true,
  "msg": "查询成功",
  "data": {
    "qq": "1194142028",
    "name": "Swaggy Macro୧⍤⃝💰",
    "email": "1194142028@qq.com",
    "avatar": "https://q2.qlogo.cn/headimg_dl?dst_uin=1194142028&spec=640"
  },
  "time": "2025-12-11 13:01:33",
  "api_vers": "qqinfo_v5"
}

原本返回信息很多，包含QQ号等级、年龄、性别、所在地等等，但是似乎没什么意义，为了稳定还是只返回昵称吧。

获取接口

经历了上一次事件，所以我加上了 Token 鉴权，而且还是写死在 php 里的，没调数据库，有需要的可以在评论区留言，我会用邮件回复你 Token。