QQ信息查询TM 接口文档

接口说明

QQ信息查询TM 是一款免费的 QQ 信息查询 API 接口，支持通过输入 QQ 号获取该账号的详细资料信息，包括昵称、个性签名、性别、年龄、QQ 等级、VIP 信息、地址、注册时间等丰富数据。

本接口采用 GET/POST 请求方式，返回 JSON 格式数据，具有稳定、易用、响应快速等特点，适用于各类需要 QQ 信息查询的应用场景。

调用地址

https://api.xunjinlu.fun/apis/tmqqinfos

请求方式

• GET
• POST

鉴权方式

本接口支持以下三种鉴权方式，调用方可根据实际需求选择其中一种：

1. Query 参数：在 URL 查询字符串中传递 key 参数
2. Header：在请求头中设置 X-API-Key 字段
3. Bearer Token：在 Authorization 请求头中使用 Bearer 认证方式

计费说明

本接口为免费接口，无需消耗积分即可调用。

请求参数

参数说明

key

• 类型：string
• 必填：是
• 说明：接口访问密钥，用于身份鉴权。开发者需在平台申请获取有效的 API Key。
• 示例：sk_xxxxxxxxxxxxxxxx

qq

• 类型：string
• 必填：是
• 说明：需要查询的 QQ 账号，仅支持数字格式。
• 示例：2103533242

请求示例

示例一：Query 参数鉴权（GET）

GET https://api.xunjinlu.fun/apis/tmqqinfos?key=sk_xxxxxxxxxxxxxxxx&qq=2103533242 HTTP/1.1
Host: api.xunjinlu.fun

示例二：Header 鉴权（GET）

GET https://api.xunjinlu.fun/apis/tmqqinfos?qq=2103533242 HTTP/1.1
Host: api.xunjinlu.fun
X-API-Key: sk_xxxxxxxxxxxxxxxx

示例三：Bearer Token 鉴权（GET）

GET https://api.xunjinlu.fun/apis/tmqqinfos?qq=2103533242 HTTP/1.1
Host: api.xunjinlu.fun
Authorization: Bearer sk_xxxxxxxxxxxxxxxx

示例四：POST 请求

POST https://api.xunjinlu.fun/apis/tmqqinfos HTTP/1.1
Host: api.xunjinlu.fun
Content-Type: application/x-www-form-urlencoded
X-API-Key: sk_xxxxxxxxxxxxxxxx

qq=2103533242

成功响应示例

{
  "code": 200,
  "message": "success",
  "qq": "2103533242",
  "data": {
    "uin": "2103533242",
    "nick": "Ash",
    "qid": "ComoeXJS",
    "sex": "male",
    "age": 0,
    "birthday": "0-0-0",
    "constellation": 0,
    "shengXiao": 10,
    "blood_type": 0,
    "qq_level": 0,
    "is_vip": false,
    "is_years_vip": false,
    "vip_level": 0,
    "long_nick": "人生如戏 戏如人生",
    "country": "",
    "province": "",
    "city": "",
    "address": "",
    "college": "",
    "reg_time": 1514803052,
    "status": 20,
    "phone_num": "-",
    "email": "",
    "interest": ""
  }
}

响应字段说明

顶层响应字段

data 对象字段

错误响应示例

当请求出现错误时，接口将返回统一的错误响应格式：

{
  "code": 0,
  "msg": "未提供密钥",
  "errcode": 11001
}

业务错误码说明

频率限制

本接口设有频率限制，具体如下：

• 限制频率：每分钟约 60 次
• 建议策略：请合理控制请求频率，避免触发限流机制

如需更高频率的调用，请联系平台管理员咨询升级方案。

调用示例

PHP 示例

// QQ信息查询TM - PHP示例

// 配置参数
$apiUrl = 'https://api.xunjinlu.fun/apis/tmqqinfos';
$apiKey = 'sk_xxxxxxxxxxxxxxxx'; // 替换为您的API Key
$qqNumber = '2103533242'; // 替换为要查询的QQ号

// 方式一：Query参数鉴权
$url = $apiUrl . '?key=' . urlencode($apiKey) . '&qq=' . urlencode($qqNumber);

// 方式二：Header鉴权（取消下方注释使用）
// $url = $apiUrl . '?qq=' . urlencode($qqNumber);

// 初始化cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);

// 如使用Header鉴权，取消下方注释
// curl_setopt($ch, CURLOPT_HTTPHEADER, array(
//     'X-API-Key: ' . $apiKey
// ));

// 如使用Bearer Token鉴权，取消下方注释
// curl_setopt($ch, CURLOPT_HTTPHEADER, array(
//     'Authorization: Bearer ' . $apiKey
// ));

// 执行请求
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 解析响应
if ($httpCode == 200) {
    $result = json_decode($response, true);
    if ($result['code'] == 200) {
        echo "查询成功！\n";
        echo "QQ号: " . $result['data']['uin'] . "\n";
        echo "昵称: " . $result['data']['nick'] . "\n";
        echo "个性签名: " . $result['data']['long_nick'] . "\n";
        echo "性别: " . $result['data']['sex'] . "\n";
        echo "QQ等级: " . $result['data']['qq_level'] . "\n";
        echo "VIP状态: " . ($result['data']['is_vip'] ? '是' : '否') . "\n";
    } else {
        echo "查询失败: " . $result['msg'] . "\n";
    }
} else {
    echo "请求失败，HTTP状态码: " . $httpCode . "\n";
}

JavaScript 示例

// QQ信息查询TM - JavaScript示例

const apiUrl = 'https://api.xunjinlu.fun/apis/tmqqinfos';
const apiKey = 'sk_xxxxxxxxxxxxxxxx'; // 替换为您的API Key
const qqNumber = '2103533242'; // 替换为要查询的QQ号

// 方式一：Query参数鉴权
fetch(`${apiUrl}?key=${encodeURIComponent(keyKey)}&qq=${encodeURIComponent(qqNumber)}`)
    .then(response => response.json())
    .then(data => {
        if (data.code === 200) {
            console.log('查询成功！');
            console.log('QQ号:', data.data.uin);
            console.log('昵称:', data.data.nick);
            console.log('个性签名:', data.data.long_nick);
            console.log('性别:', data.data.sex);
            console.log('QQ等级:', data.data.qq_level);
            console.log('VIP状态:', data.data.is_vip ? '是' : '否');
        } else {
            console.error('查询失败:', data.msg);
        }
    })
    .catch(error => {
        console.error('请求错误:', error);
    });

// 方式二：Header鉴权（取消下方注释使用）
/*
fetch(`${apiUrl}?qq=${encodeURIComponent(qqNumber)}`, {
    headers: {
        'X-API-Key': apiKey
    }
})
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error(error));
*/

// 方式三：Bearer Token鉴权（取消下方注释使用）
/*
fetch(`${apiUrl}?qq=${encodeURIComponent(qqNumber)}`, {
    headers: {
        'Authorization': `Bearer ${apiKey}`
    }
})
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error(error));
*/

Python 示例

# QQ信息查询TM - Python示例

import requests

api_url = 'https://api.xunjinlu.fun/apis/tmqqinfos'
api_key = 'sk_xxxxxxxxxxxxxxxx'  # 替换为您的API Key
qq_number = '2103533242'  # 替换为要查询的QQ号

# 方式一：Query参数鉴权
params = {
    'key': api_key,
    'qq': qq_number
}

# 方式二：Header鉴权（取消下方注释使用）
# params = {'qq': qq_number}
# headers = {'X-API-Key': api_key}

# 方式三：Bearer Token鉴权（取消下方注释使用）
# params = {'qq': qq_number}
# headers = {'Authorization': f'Bearer {api_key}'}

try:
    response = requests.get(api_url, params=params, timeout=30)
    result = response.json()

    if result['code'] == 200:
        print('查询成功！')
        print(f"QQ号: {result['data']['uin']}")
        print(f"昵称: {result['data']['nick']}")
        print(f"个性签名: {result['data']['long_nick']}")
        print(f"性别: {result['data']['sex']}")
        print(f"QQ等级: {result['data']['qq_level']}")
        print(f"VIP状态: {'是' if result['data']['is_vip'] else '否'}")
    else:
        print(f"查询失败: {result['msg']}")

except requests.exceptions.RequestException as e:
    print(f"请求错误: {e}")

注意事项

1. 密钥安全：请妥善保管您的 API Key，避免泄露。建议不要在客户端代码中硬编码密钥。
2. 频率控制：请遵守接口频率限制，避免因频繁请求导致服务受限。
3. 数据缓存：建议对查询结果进行适当缓存，减少重复查询，提升应用性能。
4. 错误处理：请在代码中正确处理各种错误情况，包括网络错误、鉴权失败、频率限制等。
5. 隐私保护：本接口返回的数据可能涉及用户隐私，请确保您的使用符合相关法律法规要求。

常见问题

Q：接口返回的 age 为 0 是什么意思？
A：age 为 0 表示该用户未公开年龄信息或系统未能获取到该数据。

Q：reg_time 字段是什么格式？
A：reg_time 是 Unix 时间戳格式，表示 QQ 账号的注册时间，您可以通过相关函数转换为可读的日期时间格式。

Q：如何提高查询成功率？
A：请确保输入的 QQ 号正确无误，并遵守接口频率限制。如遇到临时性错误，可稍后重试。

Q：接口支持批量查询吗？
A：本接口暂不支持批量查询，每次请求仅可查询一个 QQ 号。如需批量查询，请循环调用接口，并注意控制请求频率。

文档最后更新时间：2026年