Skip to content

Retrieve QQ Nickname and Avatar

1. Basic Usage

Use the following URL to retrieve a QQ nickname and avatar:

txt
https://zeapi.ink/v1/api/qqinfo?qq=94113786&size=100

2. Request Parameters

ParameterTypeRequiredDefault ValueDescription
qqstringYesNoneThe QQ number to query
sizeintNo100Avatar size (pixels, equal width and height)

Size Parameter Mapping:

Size ValueActual Size
140×40
240×40
3100×100
4140×140
5640×640
4040×40
100100×100

3. JSON Response Format

Success Response Example:

json
{
    "status": "success",
    "data": {
        "qq": "94113786",
        "nickname": "梦泽",
        "avatar": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...",
        "size": 100
    }
}

Error Response Example:

json
{
    "status": "error",
    "message": "Missing or invalid parameter: qq"
}

4. Response Fields Description

FieldTypeDescription
statusstringRequest status (success/error)
messagestringError message (returned only when status=error)
data.qqstringQueried QQ number
data.nicknamestringQQ nickname
data.avatarstringBase64-encoded avatar image data
data.sizeintActual size of the returned avatar

Released under the MIT License.