手机号-归属地查询

接口说明

提供手机号码归属地查询服务，可返回号码对应的省份、城市及运营商信息。适用于需要验证手机号归属地或进行号码校验的业务场景，无需鉴权，调用免费。

调用地址

/api/tools/phone_location.php

请求方式

GET

鉴权说明

该接口无需鉴权，直接调用即可。

请求参数

成功响应示例

{
    "code": 0,
    "msg": "查询成功",
    "data": {
        "number": "17020057281",
        "province": "广东",
        "city": "广州",
        "isp": "三五数字"
    }
}

响应字段说明

错误响应示例

{
    "code": 0,
    "msg": "请求参数错误",
    "errcode": 11001
}

业务错误码说明

调用示例

终端 curl（bash）

curl -G http://api.example.com/api/tools/phone_location.php \
  --data-urlencode 'number=17020057281'

PHP

// PHP — 手机号归属地查询
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'http://api.example.com/api/tools/phone_location.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPGET, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'number' => '17020057281',
]));
$response = curl_exec($ch);
curl_close($ch);
var_dump(json_decode($response, true));

注意事项

• 本接口无需密钥即可调用，但请妥善保管调用凭证，勿将接口地址直接暴露于前端页面或公开仓库中。
• 请求方式为 GET，参数通过 URL 查询字符串传递，确保 number 参数值为合法的手机号码。
• 接口频率限制为每分钟约 120 次，超过限制将返回 429 状态码，请合理控制调用节奏，避免触发限流。
• 参数 number 为必填项，请传入 11 位中国大陆手机号码，其他格式可能返回异常结果。
• 返回结果中的 province、city 字段均为字符串类型，部分特殊号段可能无法精确到市级，请以实际返回为准。
• 建议使用 HTTPS 协议进行接口调用，以保障数据传输安全。
• 本接口为免费服务，暂不支持批量查询，单次仅支持单个手机号归属地查询。
• 如遇查询结果为空或数据异常，可能是该号段尚未入库，建议在合理范围内重试。