全球运营商查询

上传整份号码文件，批量返回每个号码的运营商、底层运营商、线路类型、国家、地区与城市——与实时运营商查询的字段一致。

面向整份大名单的补充选项；号码不多时，实时检测同一次请求就出结果。实时检测 →

查看接口约定免费注册

两步接入：提交文件，再查询任务

查看完整 API 文档打开 API Key 页面

提交后立刻返回任务号；之后按任务号查询状态，任务成功时响应里会带上结果文件的下载链接。下面每个请求都配上它自己的响应。

1. 提交文件

立即返回任务号，此时 preparing 为 true，后台正在预处理文件：去掉无效行、重复行，号码任务还会去掉没带国家码和不属于所选国家的号码，这些都不计费。按提交行数冻结余额，完成后按实际用量结算，差额退回。

cURL 请求POST /api/v1/bulk-tasks

curl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=carrier_batch \
  -F country=US \
  -F [email protected]

响应：任务已创建200 OK

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "carrier_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

2. 查询任务

按任务号轮询。预处理完成后恒有 submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt，其中 total 是实际检测并计费的条数。任务成功时响应里带成功/失败计数和结果文件下载链接；预处理阶段被拒的任务为 failed，带 reason_detail，并全额退款。

cURL 请求GET /api/v1/bulk-tasks/{id}

curl "https://api.carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

响应：任务已完成200 OK

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "carrier_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

一个批量任务是怎么跑完的

批量不是把实时检测放大 —— 它是一次提交、后台执行、稍后取件。整个过程您不需要守着页面，任务状态和结果都留在后台。

01上传号码文件
一行一个号码的 .txt 或 .csv。文件流式提交，服务器不保存文件副本。
02预检并冻结余额
空文件、格式明显不对、行数不足等问题在上传时直接拒绝；通过后冻结余额，文件进入后台预处理：去除重复行和无效行，并校验国家一致性。预处理不通过的任务会标记为失败并全额退款；通过的只检测剩下的条目，完成后结算。
03后台执行
任务在后台跑，您可以关掉页面。失败会立即反馈并全额退款。
04下载结果文件
完成后在批量检测页下载。只按实际返回结果的号码计费，差额自动退回。

结果文件里有哪些列

下载的是一份 CSV 文件，就是完整的结果表。

结果文件的列

identifier · 12345678900 — 提交的号码，统一为带国家码的纯数字，不含加号和空格（例如 12345678900）。
carrier · T-Mobile — 号码最初被分配给的运营商。不是携号转网后的当前运营商。
underlying_carrier — 上游返回的底层运营商（与号段分配的运营商不同时才有值）；上游未提供时为空串。
number_type · Fixed Line or Mobile — 上游返回的线路类型，例如 Fixed Line or Mobile；上游未给时为空。
country_code · US — 号码所属的 ISO 国家代码。
region · CA — 号段归属地区；上游未提供时为空。
city · LOS ANGELES — 号段归属城市；上游未提供时为空。

什么时候该用这一款

名单分群
将整份号码名单按原始运营商、线路类型和归属国家或地区整理，形成可下载的数据分组。
路由成本核对
利用批量结果中的运营商和地区字段核对内部路由、采购或成本记录，减少逐条查询。
数据库清理
发现缺失原始归属运营商、地区或城市信息的号码记录，为资料补全和人工复核建立清单。也可将空值、信息不完整和与现有资料不一致的记录分开整理，避免它们混入后续的数据分析。
建议处理：先标记待复核记录，再导出清单交由数据管理员补全；完成后重新入库或重新查询。