本頁內容

來電與號碼

電話情報

API · Pro測試版

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

開啟工具
本頁內容

用途

輸入電話號碼以查看經審核且受私隱限制的資料。

風險等級 · 類別 · 運營商資訊.

使用要求

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

輸入包含國際區碼的完整號碼。使用國內號碼時,請先檢查版本所在國家或國家選擇器。

使用步驟

  1. 開啟工具

  2. 輸入包含國際區碼的完整號碼。使用國內號碼時,請先檢查版本所在國家或國家選擇器。

  3. 查詢

  4. 配合限制說明閱讀可用欄位。空白結果不能證明安全,也不能確認個人身分。

虛構範例

說明

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

虛構範例
+44 1632 960123

理解結果

配合限制說明閱讀可用欄位。空白結果不能證明安全,也不能確認個人身分。

風險等級 · 類別 · 運營商資訊.

此號碼不在我們的資料庫中。成為第一個舉報的人。

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

限制

注意

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

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

資訊基於社群舉報和自動分析。其中可能包含錯誤或已過時,不構成法律意見,也不構成對號碼所有者的核實指控。

疑難排解

輸入無效時檢查格式和國家。連線出錯時重試;達到限制後請等待指定時間。

無效的電話號碼

安全檢查或 API 連線未能及時響應。請幾秒後重試。

您已使用了今天允許的所有電話號碼查找。請明天再試一次。

透過 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 標頭中的秒數過後再重試。

包含 who-calls 回傳的所有內容,另加已核准的留言數、計入分數時的 AI 風險等級,以及該號碼前綴的回撥風險。

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

端點
POST https://api.nocall.io/v2/phone-intelligence
POST https://api.nocall.io/v2/tools  {"tool":"phone-intelligence","phone":"+12025550123","country":"US"}

參數

名稱類型必填說明
phonestring (1–40)是E.164(+34…)或國內格式的電話號碼。
countrystring (enum, 56)否 (預設: "ES")雙字母國家代碼,例如 ES 或 US,用於國內格式輸入和該國資料。
bash
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/phone-intelligence' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"phone":"+12025550123","country":"US"}'

回應範例(200)

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

JSON
{
  "data": {
    "tool": "phone-intelligence",
    "result": {
      "phoneNumber": "+12025550123",
      "found": true,
      "updatedAt": "2026-10-01T09:30:00.000Z",
      "risk": {
        "score": 72,
        "level": "high"
      },
      "reportCount": 14,
      "categories": [
        "TELEMARKETING"
      ],
      "verified": false,
      "carrier": null,
      "verifiedBusiness": null,
      "commentCount": 3,
      "aiRiskLevel": "high",
      "prefixRisk": null
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

結果欄位(data.result)

欄位類型說明
phoneNumberstringE.164 格式的號碼。
foundbooleanNoCall 是否有此號碼的實際資料:已具名的電信業者、封鎖清單或目錄項目、已核准的回報或已驗證商家。僅有前綴資料不算。false 仍是完成的結果。
updatedAtstring | null資料最後更新時間(ISO 8601),或 null。
riskobject0 到 100 的風險分數及其等級。
reportCountinteger已核准的社群回報數。
categoriesarray<string>被回報的類別,例如 TELEMARKETING 或 SCAM。
verifiedboolean號碼是否已驗證。
carrierobject | null來自西班牙 CNMC 登記資料或該國主管機關的電信業者資料:電信業者、號碼類型、前綴、地區和費用類別。未知時為 null。
verifiedBusinessobject | null擁有該號碼的已驗證商家,或 null。
commentCountinteger此號碼已核准的留言數。
aiRiskLevel"low" | "medium" | "high" | "critical" | null此號碼的 AI 風險等級,僅在計入風險分數時提供;否則為 null。
prefixRisk"low" | "medium" | "high" | "critical" | null此號碼前綴的回撥風險,或 null。