cURL 请求
POST /api/v1/checkcurl -X POST "https://carrierlookup.online/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "carrier", "identifier": "+14155552671" }'service_type carrier
查一个号码最初被分配给哪家运营商,并返回线路类型与归属地。
POST /api/v1/check无需登录;公开演示有每日次数限制。
接口约定
提交一个手机号,并用 service_type 选择本产品;认证使用你的 API Key。
复制下面的 curl 命令,只需将示例 API Key 替换为你自己的 Key。
POST /api/v1/checkcurl -X POST "https://carrierlookup.online/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "carrier", "identifier": "+14155552671" }'200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "carrier",
"identifier": "+14155552671",
"registered": true,
"extra": {
"carrier": "T-Mobile USA",
"number_type": "mobile",
"country_code": "US",
"region": "California",
"city": "San Francisco"
}
}
}正确使用结果
以 E.164 格式提交号码:加号、国家码,然后是用户号码,中间不带空格或分隔符 —— 例如 +14155552671。
SaaS 网页后台与同步 API 使用相同的响应结构,返回原始归属运营商等字段。
成功响应会同步返回 extra 对象;需要最新数据时请重新查询,联系用户前仍需取得相应同意。
检测内容
registered · boolean — 该号码是否查到了号段分配数据。为 false 表示这次查询没有返回任何内容。extra.carrier · string — 号码最初被分配给的运营商。不是携号转网后的当前运营商。extra.number_type · string — 上游返回的线路类型;上游未给时为空。extra.country_code · string — 号码所属的 ISO 国家代码。extra.region · string — 号段归属地区;上游未提供时为空。extra.city · string — 号段归属城市;上游未提供时为空。适用场景
直接答案
原始归属运营商查询 返回 号码最初被分配到的运营商、线路类型与归属地区。使用 service_type carrier(选择产品的参数)提交一个 E.164 格式的手机号,例如 +14155552671,并在同一次 API 响应里读取 extra 对象。
能力边界
产品常见问题
它对一个手机号进行检测,并在同一次同步响应中返回号码最初被分配到的运营商、线路类型与归属地区。
仅在检测完成后扣除余额;检测失败或无法判定的请求不会保留扣费。
提交一个 E.164 格式的手机号,例如 +14155552671。国家码本身就是号码的一部分,因此不需要另外选择国家。
不是。结果只说明号码最初被分配到哪个网络;它不跟踪携号转网,也不代表号码当前可达。联系前的同意与适用规则仍需由你自行遵守。