手机号查询
正常 NEW大陆手机号离线解析引擎。基于工信部号段分配表, 返回号段归属运营商 (移动/联通/电信/广电/虚拟运营商/卫星)、卡类型 (普通/虚拟运营商卡/物联网卡/无线上网卡/卫星电话) 与客服热线。纯离线、无外部 API 依赖, 默认脱敏返回, 不落库号码。
¥
0.002
/ 次
按次计费
健康检查 。
健康检查 。
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/phone/ping
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.version | string | - |
| data.time | string | - |
请求示例
返回示例
{"msg":"pong","code":0,"data":{"time":"2026-11-01 12:00:00","version":"1.0"}}
号段库统计 。
号段库统计 。
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/phone/stats
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.status | string | - |
| data.carriers | int | - |
| data.segments | int | - |
| data.by_carrier | object | - |
| data.by_type | object | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"status":"ok","by_type":{"normal":44},"carriers":6,"segments":55,"by_carrier":{"cmcc":{"name":"中国移动","count":22}}}}
运营商目录 。可选参数 category: base 基础运营商 / vno 虚
运营商目录 。可选参数 category: base 基础运营商 / vno 虚拟运营商 / satellite 卫星通信。
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/phone/carriers
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.total | int | - |
| data.list | array | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"list":[{"en":"China Mobile","code":"cmcc","name":"中国移动","hotline":"10086","category":"base"}],"total":6}}
单号解析。Body: {"phone": "138 1234 5678", "r
单号解析。Body: {"phone": "138 1234 5678", "raw": false}
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
POST
http://www.shujuyu.cn/v1/api/phone/parse
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| phone | string | 是 | - |
| raw | bool | 是 | - |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.phone | string | - |
| data.masked | string | - |
| data.is_valid | bool | - |
| data.country_code | string | - |
| data.e164 | string | - |
| data.segment | string | - |
| data.matched | bool | - |
| data.card_type | string | - |
| data.card_type_name | string | - |
| data.carrier | object | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"e164":"+8613812345678","phone":"138****5678","masked":"138****5678","carrier":{"en":"China Mobile","code":"cmcc","name":"中国移动","hotline":"10086","category":"base"},"matched":true,"segment":"138","is_valid":true,"card_type":"normal","country_code":"+86","card_type_name":"普通手机卡"}}
批量解析, 最多 10 条。Body: {"phones": ["1381234
批量解析, 最多 10 条。Body: {"phones": ["13812345678", "+8618912345678"], "raw": false}
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
POST
http://www.shujuyu.cn/v1/api/phone/parse-batch
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| phones | array | 是 | - |
| raw | bool | 是 | - |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.total | int | - |
| data.valid | int | - |
| data.invalid | int | - |
| data.matched | int | - |
| data.by_carrier | object | - |
| data.by_type | object | - |
| data.max_limit | int | - |
| data.list | array | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"list":[{"e164":"+8613812345678","index":0,"phone":"138****5678","masked":"138****5678","carrier":{"en":"China Mobile","code":"cmcc","name":"中国移动","hotline":"10086","category":"base"},"matched":true,"segment":"138","is_valid":true,"card_type":"normal","country_code":"+86","card_type_name":"普通手机卡"},{"e164":"+8618912345678","index":1,"phone":"189****5678","masked":"189****5678","carrier":{"en":"China Telecom","code":"ctcc","name":"中国电信","hotline":"10000","category":"base"},"matched":true,"segment":"189","is_valid":true,"card_type":"normal","country_code":"+86","card_type_name":"普通手机卡"}],"total":2,"valid":2,"by_type":{"normal":2},"invalid":0,"matched":2,"max_limit":10,"by_carrier":{"cmcc":1,"ctcc":1}}}
产品说明
产品概述
大陆手机号离线解析引擎。基于工信部号段分配表, 返回号段归属运营商 (移动/联通/电信/广电/虚拟运营商/卫星)、卡类型 (普通/虚拟运营商卡/物联网卡/无线上网卡/卫星电话) 与客服热线。纯离线、无外部 API 依赖, 默认脱敏返回, 不落库号码。
使用场景
数据查询：快速集成 手机号查询 到您的应用中
业务系统：将 手机号查询 数据嵌入业务流程
开发工具：通过 API 接口获取 生活服务 数据
数据分析：基于 手机号查询 数据进行分析和决策
费用计算
按次计费单价
¥0.002
/ 次
每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣
扣费优先级
免费额度
次数包
余额扣费
计费方式详解
1
免费额度
· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次 的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次 的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。
2
次数包
预付费购买固定调用次数，折算单价与按次付费相同，用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。
3
余额扣费
按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣： 个人版9折 专业版8折 企业版7折
量折扣： 月付费调用 ≥1000 次享 2%、 月付费调用 ≥10000 次享 5%、 月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣： 个人版9折 专业版8折 企业版7折
量折扣： 月付费调用 ≥1000 次享 2%、 月付费调用 ≥10000 次享 5%、 月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。
VIP 权益对比
| 等级 | 每月免费次数 | 本接口月免费上限 | 折扣 | VIP 折后单价 |
|---|---|---|---|---|
| 免费版 | 按接口配置 | — | - | ¥0.002/次 |
| 个人版 | 5000 次 | 5000 次 | 10% | ¥0.0018/次 |
| 专业版 | 30000 次 | 30000 次 | 20% | ¥0.0016/次 |
| 企业版推荐 | 200000 次 | 200000 次 | 30% | ¥0.0014/次 |
* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。
本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。
费用计算示例
* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。
示例1：普通用户按次付费
调用 1000 次，费用 = 0.002 × 1000 = ¥2.00
示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）
调用 1000 次，折扣约 10%，费用 = 0.002 × (1 - 10%) × 1000 ≈ ¥1.80
错误码说明
本接口未定义专属错误码，调用时请参考通用错误码体系。
查看通用错误码参考
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 200 | 请求成功 | - |
| 400000 | 请求参数错误 | 检查参数名、格式与取值 |
| 401000 | 认证失败 | 检查 Authorization: Bearer 密钥是否正确、是否过期 |
| 401002 | 缺少 API 认证参数 | 请求未携带 key，请通过 URL 参数 key 或请求头 Authorization 传递密钥 |
| 402000 | 账户余额不足 | 充值后重试 |
| 403000 | 无访问权限 | 确认密钥权限、接口范围与 IP 白名单是否满足要求 |
| 404001 | 接口或端点不存在 | 检查 API 与端点的请求路径 |
| 409000 | 请求冲突 | 请稍后重试 |
| 422000 | 参数校验失败 | 检查参数格式与取值 |
| 429001 | 请求频率超限（QPS） | 降低请求频率，或升级套餐提升额度 |
| 429002 | 分钟级调用频率超限 | 降低调用频率，或升级套餐提升额度 |
| 429003 | 小时级调用额度已用完 | 升级套餐提升额度，或整点后重试 |
| 429004 | 今日调用额度已用完 | 升级套餐提升额度，或次日重试 |
| 500000 | 服务器内部错误 | 携带响应中的 request_id 联系技术支持 |
| 502000 | 服务暂时不可用 | 稍后重试 |
| 503000 | 服务暂时不可用 | 稍后重试 |
| 504000 | 请求超时 | 稍后重试 |
更新日志
暂无更新日志