Adresáře
Spamová čísla
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ástrojNa této stránce
Účel
Otevřete adresář své edice, zvolte kategorii a otevřete záznam. Počty popisují dostupná data NoCall, nikoli všechny hovory v zemi. Chybějící data nedokazují, že je číslo bezpečné.
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.
Jak používat
Vyberte edici země, otevřete kategorii nebo řádek a prohlédněte dostupné podrobnosti.
Kategorie
Nejvíce nahlašovaná čísla
Smyšlený příklad
Smyšlený příklad, nikoli skutečný dotaz. Nevolejte ani neotevírejte jeho odkazy.
+44 1632 960123Jak chápat výsledek
Toto číslo není v naší databázi. Buďte první, kdo ho nahlásí.
Toto číslo má hlášení nechtěných hovorů
Omezení
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íží
Bezpečnostní kontrola nebo připojení k API neodpovědělo včas. Zkuste to znovu za pár sekund.
Čtěte dostupná pole spolu s omezeními. Prázdný výsledek nedokazuje bezpečnost ani neurčuje totožnost osoby.
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.
Veřejné statistiky spamu pro zemi, nebo veřejně uvedená čísla jedné kategorie, stránkované. page × limit je omezeno na 100 000 řádků, stejně jako ve veřejném adresáři. Studená mezipaměť vrací 503 tool_warming.
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/spam-directory
POST https://api.nocall.io/v2/tools {"tool":"spam-directory","country":"US","category":"SCAM","page":1,"limit":20}Parametry
| Název | Typ | Povinný | Popis |
|---|---|---|---|
| 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ě. |
| category | "TELEMARKETING" | "SCAM" | "DEBT" | "HARASSMENT" | "SURVEY" | "SPAM" | Ne | Kategorie spamu. Bez ní se vrací souhrn za zemi a page a limit se ignorují. page × limit může být nejvýše 100 000. |
| page | integer (1–10000) | Ne (výchozí: 1) | Číslo stránky, počínaje 1. |
| limit | integer (1–50) | Ne (výchozí: 20) | Počet výsledků na stránku. |
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/spam-directory' \
--header "Authorization: Bearer $NOCALL_API_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{"country":"US","category":"SCAM","page":1,"limit":20}'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/spam-directory',
method='POST',
data=json.dumps({'country': 'US', 'category': 'SCAM', 'page': 1, 'limit': 20}).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/spam-directory', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ country: 'US', category: 'SCAM', page: 1, limit: 20 }),
});
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": "spam-directory",
"result": {
"view": "category",
"category": "SCAM",
"total": 2,
"page": 1,
"limit": 20,
"hasMore": false,
"rows": [
{
"phoneNumber": "+15555550123",
"category": "SCAM",
"reportCount": 4
},
{
"phoneNumber": "+15555550142",
"category": "SCAM",
"reportCount": 2
}
]
}
},
"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 |
|---|---|---|
| view | "summary" | "category" | "summary" bez kategorie; "category" s kategorií. |
| totals | object | Celkové počty blokovaných čísel, hlášení a komentářů. |
| categories | array<object> | Počet hlášení v každé kategorii. |
| topReported | array<object> | 20 nejčastěji nahlášených čísel (souhrnné zobrazení), každé s datem posledního hlášení v ISO 8601 UTC, nebo null. |
| category | "TELEMARKETING" | "SCAM" | "DEBT" | "HARASSMENT" | "SURVEY" | "SPAM" | Zobrazená kategorie (zobrazení category). |
| total | integer | Celkový počet odpovídajících řádků. |
| page | integer | Aktuální stránka. |
| limit | integer | Počet řádků na stránku. |
| hasMore | boolean | Zda po této stránce zbývají další řádky. |
| rows | array<object> | Veřejně uvedená čísla kategorie na této stránce, každé s kategorií a počtem schválených hlášení (zobrazení kategorie). |
