電信業者

API · Pro2026-10-28

涵蓋範圍: 地區資訊來自各站所屬國家的官方編碼計畫。西班牙為每個市話號碼區段列出了省份；許多其他國家列出了區碼和城市。任何國家的手機號碼都沒有地區，少數國家尚未公布我們能讀取的編碼計畫：對這些國家我們只顯示線路類型。

開啟工具

本頁內容

用途

開啟所選版本的目錄，選擇分類並查看項目。數量表示 NoCall 中可用的資料，而非該國全部通話。缺少資料不能證明號碼安全。

使用要求

任何 NoCall 帳號都可以閱讀這些指南。部分工具需要 Pro，各指南會註明。

使用步驟

選擇國家版本，開啟所需分類或項目，查看可用詳細資料。
按運營商或號段篩選
運營商

虛構範例

此範例為虛構內容，並非真實查詢。請勿撥打電話或開啟其中的連結。

+44 1632 960123

理解結果

參考資訊，來自公開的編碼計畫。它描述的是號碼類型，而不是號碼背後的個人或公司。

僅顯示經審核或公開的技術資料，不顯示私人身分和防護訊號。

限制

僅提供格式和支援的區碼，不能證明號碼的位置、持有人或使用狀態。部分區碼由多個地區共用。

疑難排解

請嘗試其他品牌、法定名稱或三位數號段。

請幾分鐘後重試，或直接查詢一個號碼。

透過 API 使用

需要 API 金鑰和點數。每次完成的呼叫扣 1 點，即使沒有資料也一樣。有效的 Pro 帳戶每個 UTC 曆月包含 20 點，由所有 API 路由共用並優先扣用；當月未使用的點數不會累積到下個月。在帳戶頁面購買的點數不需 Pro 即可使用，且永不過期。

錯誤一律不扣點：401 invalid_api_key（缺少金鑰或金鑰無效）、403 pro_required（沒有 Pro 點數，也沒有購買的點數）、422 輸入無效、429 quota_exceeded（點數用完）、rate_limit_exceeded 或 ai_busy（sms-check 的 AI 已達負載上限）、503 tool_warming（資料仍在準備中）或 tool 或供應商無法使用。收到 429 或 503 後，請等 Retry-After 標頭中的秒數過後再重試。

西班牙電信業者及其前綴、號碼類型和垃圾來電數，另含特殊前綴。僅限 ES。

將 JSON 主體傳送到該 tool 專屬的路由，或加上 tool 欄位後傳送到 POST /v2/tools。兩種路由回傳的結果相同。

POST https://api.nocall.io/v2/operator-directory
POST https://api.nocall.io/v2/tools  {"tool":"operator-directory","country":"ES","operator":"Movistar"}

參數

名稱	類型	必填	說明
country	"ES"	否 (預設: "ES")	資料所屬國家。僅支援 ES。
operator	string (1–60)	否	只列出此電信業者，依名稱指定。

REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/operator-directory' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"country":"ES","operator":"Movistar"}'

import json
import os
import urllib.request
import uuid

api_key = os.environ.get('NOCALL_API_KEY')
if not api_key:
    raise SystemExit('Set NOCALL_API_KEY')

request = urllib.request.Request(
    'https://api.nocall.io/v2/operator-directory',
    method='POST',
    data=json.dumps({'country': 'ES', 'operator': 'Movistar'}).encode(),
    headers={
        'Authorization': 'Bearer ' + api_key,
        'Content-Type': 'application/json',
        'Idempotency-Key': str(uuid.uuid4()),
    },
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)
print(result['data']['result'], result['meta']['unitsCharged'])

import { randomUUID } from 'node:crypto';

const requestId = randomUUID();
const apiKey = process.env.NOCALL_API_KEY;
if (!apiKey) throw new Error('Set NOCALL_API_KEY');

const response = await fetch('https://api.nocall.io/v2/operator-directory', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestId,
  },
  body: JSON.stringify({ country: 'ES', operator: 'Movistar' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);

回應範例（200）

這是 API 參考文件中的範例。查詢使用虛構號碼，彙總資料和 AI 回答只呈現結果的結構，並非即時資料。

{
  "data": {
    "tool": "operator-directory",
    "result": {
      "operators": [
        {
          "name": "Movistar",
          "prefixes": [
            "609",
            "619"
          ],
          "numberType": "mobile",
          "spamCount": 0
        }
      ],
      "specialPrefixes": [
        {
          "prefix": "400",
          "name": "Llamadas comerciales",
          "type": "commercial",
          "cost": "no_callback",
          "risk": "medium"
        },
        {
          "prefix": "800",
          "name": "Llamada gratuita",
          "type": "toll_free",
          "cost": "free",
          "risk": "low"
        },
        {
          "prefix": "900",
          "name": "Llamada gratuita",
          "type": "toll_free",
          "cost": "free",
          "risk": "low"
        },
        {
          "prefix": "901",
          "name": "Coste compartido",
          "type": "premium",
          "cost": "shared",
          "risk": "medium"
        },
        {
          "prefix": "902",
          "name": "Coste extra",
          "type": "premium",
          "cost": "expensive",
          "risk": "high"
        },
        {
          "prefix": "903",
          "name": "Teléfono premium",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "critical"
        },
        {
          "prefix": "905",
          "name": "Televoto",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "critical"
        },
        {
          "prefix": "906",
          "name": "Teléfono premium",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "critical"
        },
        {
          "prefix": "907",
          "name": "VoIP España",
          "type": "premium",
          "cost": "expensive",
          "risk": "high"
        },
        {
          "prefix": "908",
          "name": "VoIP España",
          "type": "premium",
          "cost": "expensive",
          "risk": "high"
        },
        {
          "prefix": "909",
          "name": "VoIP España",
          "type": "premium",
          "cost": "expensive",
          "risk": "high"
        },
        {
          "prefix": "803",
          "name": "Servicios para adultos",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "critical"
        },
        {
          "prefix": "806",
          "name": "Entretenimiento",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "high"
        },
        {
          "prefix": "807",
          "name": "Servicios profesionales",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "high"
        },
        {
          "prefix": "704",
          "name": "Número personal",
          "type": "premium",
          "cost": "expensive",
          "risk": "medium"
        }
      ]
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

結果欄位（data.result）

欄位	類型	說明
operators	array<object>	電信業者及其前綴、號碼類型和垃圾來電數（無資料時為 null）。
specialPrefixes	array<object>	特殊前綴及其名稱、類型、費用和風險。

API 參考文件

用途