手机号归属地

上新

手机号归属地:本站号段库查询省市与运营商,支持批量(最多 50)

手机号码归属地查询:根据手机号前 7 位号段,在本站本地库中查询省份、城市、运营商、邮编与区号。

说明:
- 纯本地查询,不联网、不访问运营商;延迟低、成本低。
- 支持单个 phone 或批量 phones(最多 50 个,自动去重)。
- 结果为号段登记归属,不保证携号转网后的实际运营商。
- 号段库文件:includes/data/phone.dat(站点 cron 默认每 7 天自动检查更新)

参数:
- phone / mobile:单个 11 位国内手机号(可带 +86)
- phones / mobiles:批量数组,最多 50 个

调用地址:https://api.ynlskj.com.cn/gateway/phoneloc

请求方法:POST

在其他地方怎么调用

  1. 请求地址用上面的调用地址,把 JSON 放在请求体里
  2. 方法用 POST
  3. API Key 只能放在请求头 X-API-Key,不要写进网址,也不要写进 Query 框
  4. Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key

参数说明

参数位置必填说明
phoneBody JSON二选一单个 11 位手机号。也可用 mobile / tel。可带 +86
phonesBody JSON二选一批量手机号数组,最多 50 个。也可用 mobiles / numbers。去重后查询
X-API-KeyHeader你的 API Key

原理说明

取手机号前 7 位号段,在本站 phone.dat 中二分查找,得到省、市、运营商、邮编、区号。全程本地完成,不访问运营商。

请求示例

场景Body 示例
单个查询{"phone":"13800138000"}
批量查询{"phones":["13800138000","18600000000","19212345678"]}
带国家码{"mobile":"+8618600000000"}
超量(会报错){"phones":[...51个...]} → 最多 50 个

单个返回扁平字段;批量返回 data.list / data.failed。结果为号段登记归属,不反映携号转网。号段库随站点 cron 自动更新(默认 7 天)。

返回说明

字段说明
retok 成功,err 失败
data.phone单个查询时:phone / prefix / province / city / isp / zip / area_code / dat_version
data.count / fail_count批量时:成功条数 / 失败条数
data.list批量成功结果数组(字段同单个查询)
data.failed批量失败项:[{phone, errmsg}, ...]
data.note说明:本地号段查询,不含携号转网
msg本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」
remain_quota本次调用后的剩余次数

可直接复制的代码

未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。

<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/phoneloc');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{
    "phones": [
        "13800138000",
        "18600000000"
    ]
}',
]);
echo curl_exec($ch);

请求参数演示

{"phones":["13800138000","18600000000"]}

响应演示

{"ret":"ok","data":{"count":2,"fail_count":0,"list":[{"phone":"13800138000","prefix":"1380013","province":"北京","city":"北京","isp":"中国移动","isp_code":1,"zip":"100000","area_code":"010","dat_version":"2502","note":"基于本站号段库本地查询,不反映携号转网后的实际运营商;仅供参考"},{"phone":"18600000000","prefix":"1860000","province":"北京","city":"北京","isp":"中国联通","isp_code":2,"zip":"100000","area_code":"010","dat_version":"2502","note":"基于本站号段库本地查询,不反映携号转网后的实际运营商;仅供参考"}],"failed":[],"note":"基于本站号段库本地查询,不反映携号转网后的实际运营商;仅供参考"}}

在线调试

登录后可在线调试。调试会真实调用网关并消耗次数。

去登录