UapiProUApiPro
社交

查询 QQ 群信息

0次调用
4 积分/次

想在你的应用里展示QQ群信息？这个接口让你轻松获取群名称、群头像、群简介、成员数量等详细公开信息。

GET
uapis.cn
/api/v1/social/qq/groupinfo
查询参数
1
group_id
string
required

QQ群号，长度5-12位

功能概述

你只需要提供一个QQ群号（5-12位纯数字），接口就会返回该群的完整公开信息。我们会先验证群号的有效性，确保返回的数据准确可靠。接口响应速度快，数据结构清晰，非常适合集成到各类应用场景中。

小贴士

加群链接与二维码目前仅支持移动端。 建议引导用户使用手机 QQ 扫描join_qrcode 加入。

查询参数

group_id
string必填

QQ群号，长度5-12位

响应

200 / 请求成功

成功响应，返回QQ群的详细信息

JSON
{
  // 群号
  "group_id": "526357265",
  // 群名称
  "group_name": "罗小黑桌宠二群",
  // 群头像URL（标准尺寸100x100）
  "avatar_url": "https://p.qlogo.cn/gh/526357265/526357265_1/100",
  // 群描述/简介
  "description": "在这里，发现更多~",
  // 群标签
  "tag": "推荐群聊",
  // 加群链接
  "join_url": "https://qun.qq.com/universal-share/share?ac=1&svctype=5&tempid=h5_group_info&busi_data=eyJncm91cENvZGUiOiI1MjYzNTcyNjUifQ%3D%3D",
  // 加群二维码图片 URL（内容同 `join_url`）
  "join_qrcode": "https://uapis.cn/api/v1/image/qrcode?size=256&text=https%3A%2F%2Fqun.qq.com%2Funiversal-share%2Fshare%3Fac%3D1%26svctype%3D5%26tempid%3Dh5_group_info%26busi_data%3DeyJncm91cENvZGUiOiI1MjYzNTcyNjUifQ%253D%253D",
  // 最后更新时间（ISO 8601格式）
  "last_updated": "2025-10-04T12:34:56Z",
  // 当前成员数
  "member_count": 498,
  // 最大成员数
  "max_member_count": 500,
  // 活跃成员数（可选，部分群有此数据）
  "active_member_num": 856,
  // 群主QQ号（可选）
  "owner_uin": "1164779091",
  // 群主UID（可选）
  "owner_uid": "u_IuagWQ41A6XZhfJv4UpYqA",
  // 建群时间戳（Unix时间戳，可选）
  "create_time": 1652321207,
  // 建群时间格式化字符串（可选）
  "create_time_str": "2022-05-12 10:06:47",
  // 群等级（可选）
  "group_grade": 3,
  // 群公告/简介（可选）
  "group_memo": "欢迎加入本群",
  // 认证类型（0=未认证，可选）
  "cert_type": 0,
  // 认证说明文本（可选）
  "cert_text": "官方认证群"
}

400 / 错误的请求

缺少或无效的group_id参数

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing or invalid 'group_id' parameter."
}

404 / 未找到

QQ群不存在或暂时无法访问

JSON
{
  "error": "QQ群不存在或无法访问"
}
上一篇查询 B站直播间
下一篇查询 GitHub 仓库