Hovory a čísla

Telefonní inteligence

API · ProBeta2026-10-28

Pokrytí: Oblasti pocházejí z oficiálního číslovacího plánu země každé edice. Španělsko uvádí provincii pro každý rozsah pevných linek; mnoho dalších zemí uvádí své předvolby a města. Mobilní čísla nemají oblast v žádné zemi a několik zemí zatím nezveřejňuje plán, který bychom mohli načíst: tam ukazujeme jen druh linky.

Otevřít nástroj

Na této stránce

Účel

Zadejte číslo a zobrazte schválené údaje omezené ochranou soukromí.

Úroveň rizika · Kategorie · Informace o operátorovi.

Požadavky

Tyto návody může číst kdokoli, i bez účtu. Některé nástroje vyžadují Pro, jak uvádí příslušný návod.

Zadejte celé číslo s mezinárodní předvolbou. U národního čísla nejprve ověřte zemi edice nebo výběru.

Jak používat

Otevřít nástroj
Zadejte celé číslo s mezinárodní předvolbou. U národního čísla nejprve ověřte zemi edice nebo výběru.
Ověřit
Čtěte dostupná pole spolu s omezeními. Prázdný výsledek nedokazuje bezpečnost ani neurčuje totožnost osoby.

Smyšlený příklad

Smyšlený příklad, nikoli skutečný dotaz. Nevolejte ani neotevírejte jeho odkazy.

+44 1632 960123

Jak chápat výsledek

Čtěte dostupná pole spolu s omezeními. Prázdný výsledek nedokazuje bezpečnost ani neurčuje totožnost osoby.

Úroveň rizika · Kategorie · Informace o operátorovi.

Toto číslo není v naší databázi. Buďte první, kdo ho nahlásí.

Zobrazujeme jen ověřená nebo veřejná technická fakta. Soukromé identity a ochranné signály zůstávají skryté.

Omezení

Zobrazujeme jen ověřená nebo veřejná technická fakta. Soukromé identity a ochranné signály zůstávají skryté.

Orientační informace ze zveřejněných číslovacích plánů. Popisuje druh čísla, nikdy osobu ani firmu, která za ním stojí.

Informace založené na hlášeních komunity a automatické analýze. Mohou obsahovat chyby nebo být zastaralé a nejsou právní radou ani ověřeným obviněním vlastníka čísla.

Řešení potíží

U neplatného vstupu ověřte formát a zemi. Při chybě spojení zkuste znovu; při dosažení limitu dodržte čekací dobu.

Neplatné telefonní číslo

Bezpečnostní kontrola nebo připojení k API neodpovědělo včas. Zkuste to znovu za pár sekund.

Použili jste všechna dnes povolená vyhledávání telefonních čísel. Zkuste to prosím znovu zítra.

Použít přes API

Vyžaduje API klíč a kredity. Každé dokončené volání stojí 1 kredit, i když nejsou k dispozici žádná data. Aktivní účet Pro zahrnuje 20 kreditů na kalendářní měsíc UTC, sdílených všemi cestami API a čerpaných jako první; nevyčerpané měsíční kredity se nepřevádějí. Kredity zakoupené na stránce vašeho účtu fungují i bez Pro a nikdy nevyprší.

Chyby se nikdy neúčtují: 401 invalid_api_key (chybějící nebo neplatný klíč), 403 pro_required (žádné kredity Pro ani zakoupené kredity), 422 neplatný vstup, 429 quota_exceeded (žádné zbývající kredity), rate_limit_exceeded nebo ai_busy (AI pro sms-check je plně vytížená), 503 tool_warming (data se teprve připravují) nebo tool či poskytovatel nedostupný. Po odpovědi 429 nebo 503 to zkuste znovu, až uplyne počet sekund z hlavičky Retry-After.

Vše, co vrací who-calls, a navíc počet schválených komentářů, úroveň rizika podle AI, pokud se započítává do skóre, a riziko zpětného volání předvolby čísla.

Pošli tělo JSON na vlastní cestu toolu, nebo na POST /v2/tools s přidaným polem tool. Obě cesty vrátí stejný výsledek.

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

Parametry

Název	Typ	Povinný	Popis
phone	string (1–40)	Ano	Telefonní číslo ve formátu E.164 (+34…) nebo v národním formátu.
country	string (enum, 56)	Ne (výchozí: "ES")	Dvoupísmenný kód země, například ES nebo US, používaný pro národní vstup a pro data dané země.

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"}'

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/phone-intelligence',
    method='POST',
    data=json.dumps({'phone': '+12025550123', 'country': 'US'}).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/phone-intelligence', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestId,
  },
  body: JSON.stringify({ phone: '+12025550123', country: 'US' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);

Ukázková odpověď (200)

Jde o zdokumentovaný příklad z reference API. Vyhledávání používají smyšlené číslo a agregace i odpovědi AI ukazují tvar výsledku, ne živá data.

{
  "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
    }
  }
}

Pole výsledku (data.result)

Pole	Typ	Popis
phoneNumber	string	Číslo ve formátu E.164.
found	boolean	Zda má NoCall k tomuto číslu skutečná data: uvedeného operátora, záznam v blokovacím seznamu nebo adresáři, schválená hlášení nebo ověřenou firmu. Samotné údaje o předvolbě se nepočítají. false je stále dokončený výsledek.
updatedAt	string \| null	Kdy byla data naposledy aktualizována (ISO 8601), nebo null.
risk	object	Rizikové skóre od 0 do 100 a jeho úroveň.
reportCount	integer	Počet schválených komunitních hlášení.
categories	array<string>	Nahlášené kategorie, například TELEMARKETING nebo SCAM.
verified	boolean	Zda bylo číslo ověřeno.
carrier	object \| null	Údaje o operátorovi ze španělského registru CNMC nebo od regulátora dané země: operátor, typ čísla, předvolba, region a cenová kategorie. null, pokud nejsou známy.
verifiedBusiness	object \| null	Ověřená firma, které číslo patří, nebo null.
commentCount	integer	Počet schválených komentářů k číslu.
aiRiskLevel	"low" \| "medium" \| "high" \| "critical" \| null	Úroveň rizika čísla podle AI, jen pokud se započítává do skóre rizika; jinak null.
prefixRisk	"low" \| "medium" \| "high" \| "critical" \| null	Riziko zpětného volání předvolby čísla, nebo null.

Dokumentace API