手机号归属地查询接口文档

接口说明

传入中国大陆 11 位手机号码，返回该号码的归属地信息，包括省份、城市、运营商、区号、邮政编码及行政区划代码等全维度数据。适用于用户信息补全、地域统计分析、风控校验等场景。

• 接口名称：手机号归属地查询
• 调用地址：https://api.xunjinlu.fun/api/74/index.php
• 请求方式：GET
• 密钥要求：必须提供有效密钥
• 鉴权方式：Query 参数
• 计费模式：免费
• 请求频率：每分钟约 60 次
• 所属分类：站长工具

请求参数

参数详细说明

• key：您的个人 API 密钥，用于身份鉴权与请求计量。请在用户中心获取并妥善保管，避免泄露。
• mobile：待查询的手机号码，必须为 11 位数字，目前仅支持中国大陆手机号段。

请求示例

GET https://api.xunjinlu.fun/api/74/index.php?key=sk_xxxxxxxxxxxxxxxx&mobile=13000000000

成功响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "mobile": "13000000000",
        "location": "云南 曲靖 联通",
        "area_code": "0874",
        "postcode": "655000",
        "division_code": "530300"
    },
    "api_info": {
        "developer": "尋鯨錄",
        "blog": "https://www.xunjinlu.fun",
        "api_platform": "https://api.xunjinlu.fun"
    }
}

响应字段说明

错误响应示例

当请求出现异常时，接口返回如下格式的 JSON 数据：

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

错误响应字段说明

业务错误码

调用示例（PHP）

// 手机号归属地查询接口调用示例
// 请求方式：GET
// 鉴权方式：Query 参数

$key = 'sk_xxxxxxxxxxxxxxxx';
$mobile = '13000000000';

$url = 'https://api.xunjinlu.fun/api/74/index.php?key=' . urlencode($key) . '&mobile=' . urlencode($mobile);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['code'] == 200) {
    echo '手机号：' . $result['data']['mobile'] . PHP_EOL;
    echo '归属地：' . $result['data']['location'] . PHP_EOL;
    echo '区号：' . $result['data']['area_code'] . PHP_EOL;
    echo '邮编：' . $result['data']['postcode'] . PHP_EOL;
    echo '行政区划码：' . $result['data']['division_code'] . PHP_EOL;
} else {
    echo '请求失败：' . $result['msg'] . '（错误码：' . $result['errcode'] . '）' . PHP_EOL;
}

注意事项

1. 密钥安全：请勿将密钥硬编码在前端页面或公开仓库中，避免被他人滥用。
2. 号码格式：请确保传入的手机号为 11 位纯数字，不含空格、横杠等分隔符。
3. 频率限制：本接口限制每分钟约 60 次请求，超出限制将返回错误码 11005，请合理控制调用频率。
4. 数据时效：归属地数据基于公开号段分配规则，实际使用情况可能因携号转网等因素与查询结果存在差异。