Na této stránce

Adresáře

Spamová čísla

API · Pro

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

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

  1. Vyberte edici země, otevřete kategorii nebo řádek a prohlédněte dostupné podrobnosti.

  2. Kategorie

  3. Nejvíce nahlašovaná čísla

Smyšlený příklad

Poznámka

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

Smyšlený příklad
+44 1632 960123

Jak 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í

Upozornění

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

Upozornění

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ší.

Poznámka

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.

Endpoint
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ázevTypPovinnýPopis
countrystring (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"NeKategorie spamu. Bez ní se vrací souhrn za zemi a page a limit se ignorují. page × limit může být nejvýše 100 000.
pageinteger (1–10000)Ne (výchozí: 1)Číslo stránky, počínaje 1.
limitinteger (1–50)Ne (výchozí: 20)Počet výsledků na stránku.
bash
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}'

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.

JSON
{
  "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)

PoleTypPopis
view"summary" | "category""summary" bez kategorie; "category" s kategorií.
totalsobjectCelkové počty blokovaných čísel, hlášení a komentářů.
categoriesarray<object>Počet hlášení v každé kategorii.
topReportedarray<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).
totalintegerCelkový počet odpovídajících řádků.
pageintegerAktuální stránka.
limitintegerPočet řádků na stránku.
hasMorebooleanZda po této stránce zbývají další řádky.
rowsarray<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).