手机号归属地
上新手机号归属地:本站号段库查询省市与运营商,支持批量(最多 50)
手机号码归属地查询:根据手机号前 7 位号段,在本站本地库中查询省份、城市、运营商、邮编与区号。
说明:
- 纯本地查询,不联网、不访问运营商;延迟低、成本低。
- 支持单个 phone 或批量 phones(最多 50 个,自动去重)。
- 结果为号段登记归属,不保证携号转网后的实际运营商。
- 号段库文件:includes/data/phone.dat(站点 cron 默认每 7 天自动检查更新)
参数:
- phone / mobile:单个 11 位国内手机号(可带 +86)
- phones / mobiles:批量数组,最多 50 个
说明:
- 纯本地查询,不联网、不访问运营商;延迟低、成本低。
- 支持单个 phone 或批量 phones(最多 50 个,自动去重)。
- 结果为号段登记归属,不保证携号转网后的实际运营商。
- 号段库文件:includes/data/phone.dat(站点 cron 默认每 7 天自动检查更新)
参数:
- phone / mobile:单个 11 位国内手机号(可带 +86)
- phones / mobiles:批量数组,最多 50 个
调用地址:https://api.ynlskj.com.cn/gateway/phoneloc
请求方法:POST
在其他地方怎么调用
- 请求地址用上面的调用地址,把 JSON 放在请求体里
- 方法用
POST - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
phone | Body JSON | 二选一 | 单个 11 位手机号。也可用 mobile / tel。可带 +86 |
phones | Body JSON | 二选一 | 批量手机号数组,最多 50 个。也可用 mobiles / numbers。去重后查询 |
X-API-Key | Header | 是 | 你的 API Key |
原理说明
取手机号前 7 位号段,在本站 phone.dat 中二分查找,得到省、市、运营商、邮编、区号。全程本地完成,不访问运营商。
请求示例
| 场景 | Body 示例 |
|---|---|
| 单个查询 | {"phone":"13800138000"} |
| 批量查询 | {"phones":["13800138000","18600000000","19212345678"]} |
| 带国家码 | {"mobile":"+8618600000000"} |
| 超量(会报错) | {"phones":[...51个...]} → 最多 50 个 |
单个返回扁平字段;批量返回 data.list / data.failed。结果为号段登记归属,不反映携号转网。号段库随站点 cron 自动更新(默认 7 天)。
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,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":"基于本站号段库本地查询,不反映携号转网后的实际运营商;仅供参考"}}