service_type carrier

原始归属运营商查询

查一个号码最初被分配给哪家运营商,并返回线路类型与归属地。

使用成本: $0.001 / 次响应方式: 同步实时POST /api/v1/check
原始归属运营商查询
公开演示

无需登录;公开演示有每日次数限制。

接口约定

一次请求,立即返回

提交一个手机号,并用 service_type 选择本产品;认证使用你的 API Key。

复制下面的 curl 命令,只需将示例 API Key 替换为你自己的 Key。

cURL 请求POST /api/v1/check
curl -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"
    }
  }
}

正确使用结果

让一次单号检测真正有用的三个细节

  1. 提交一个完整的手机号

    以 E.164 格式提交号码:加号、国家码,然后是用户号码,中间不带空格或分隔符 —— 例如 +14155552671。

  2. 读取 extra 对象

    SaaS 网页后台与同步 API 使用相同的响应结构,返回原始归属运营商等字段。

  3. 使用同步返回结果

    成功响应会同步返回 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。国家码本身就是号码的一部分,因此不需要另外选择国家。

运营商结果能说明这个号码可以打通吗?

不是。结果只说明号码最初被分配到哪个网络;它不跟踪携号转网,也不代表号码当前可达。联系前的同意与适用规则仍需由你自行遵守。

立即开始检测

创建账号后,可通过 SaaS 网页后台或 API 使用全部检测产品:同步实时检测与异步批量检测共用同一份余额。