UapiProUApiPro
Social

Query QQ Group

0calls
4 credits / call

Want to display QQ group information in your app? This endpoint makes it easy to fetch the group's name, avatar, description, member count, and other detailed public information.

GET
uapis.cn
/api/v1/social/qq/groupinfo
Query parameters
1
group_id
string
required

QQ group number, 8–12 digits.

Overview

Provide a QQ group number (8–12 digits) and the endpoint returns all of the group's public information. The group number is validated to ensure response data is accurate and reliable. The endpoint responds quickly and returns a clean structured payload, so it integrates well into many use cases.

Tip

The join link and QR code currently only support mobile devices. We recommend having users scanjoin_qrcode with mobile QQ to join.

Query parameters

group_id
stringrequired

QQ group number, 8–12 digits.

Response

200 / OK

Success. Returns QQ group details.

JSON
{
  // group number
  "group_id": "526357265",
  // Group name.
  "group_name": "Sample group name",
  // Group avatar URL (standard 100×100 size).
  "avatar_url": "https://p.qlogo.cn/gh/526357265/526357265_1/100",
  // Group description.
  "description": "Sample group description.",
  // Group tags.
  "tag": "recommended groups",
  // Join link.
  "join_url": "https://qun.qq.com/universal-share/share?ac=1&svctype=5&tempid=h5_group_info&busi_data=eyJncm91cENvZGUiOiI1MjYzNTcyNjUifQ%3D%3D",
  // Join QR-code image URL (same content as `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",
  // Last-updated time (ISO 8601 format).
  "last_updated": "2025-10-04T12:34:56Z",
  // Current member count.
  "member_count": 498,
  // Maximum member count.
  "max_member_count": 500,
  // Active member count (optional, returned by some groups).
  "active_member_num": 856,
  // Group owner QQ number (optional).
  "owner_uin": "1164779091",
  // Group owner UID (optional).
  "owner_uid": "u_IuagWQ41A6XZhfJv4UpYqA",
  // Creation timestamp (Unix time, optional).
  "create_time": 1652321207,
  // Formatted creation time (optional).
  "create_time_str": "2022-05-12 10:06:47",
  // Group level (optional).
  "group_grade": 3,
  // Group announcement description (optional).
  "group_memo": "Welcome text.",
  // Verification type (`unverified` when not certified, optional).
  "cert_type": 0,
  // Verification description text (optional).
  "cert_text": "Officially verified group"
}

400 / Bad Request

Missing or invalid group_id parameter.

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

404 / Not Found

QQ group not found or temporarily unavailable.

JSON
{
  "error": "QQ group not found or invalid access."
}
PreviousQuery Bilibili Live Room
NextQuery GitHub Repository