In questa pagina
NoCall

Elenchi

Numeri spam

API · Pro

Copertura: Le zone provengono dal piano di numerazione ufficiale del paese di ogni edizione. La Spagna indica una provincia per ogni numerazione fissa; molti altri paesi pubblicano i propri prefissi e città. I cellulari non hanno una zona in nessun paese, e alcuni paesi non pubblicano ancora un piano che possiamo leggere: lì mostriamo solo il tipo di linea.

Apri lo strumento
In questa pagina

A cosa serve

Apri l’elenco della tua edizione, scegli una categoria e apri una scheda. I conteggi descrivono i dati disponibili in NoCall, non tutte le chiamate del paese. L’assenza di dati non dimostra che un numero sia sicuro.

Requisiti

Chiunque può leggere queste guide, senza account. Alcuni strumenti richiedono Pro, come indicato in ogni guida.

Come usarlo

  1. Seleziona l’edizione del paese, apri la categoria o la riga desiderata e consulta i dettagli disponibili.

  2. Categorie

  3. Numeri più segnalati

Esempio inventato

Nota

Esempio inventato, non una ricerca reale. Non chiamare e non aprire i suoi link.

Esempio inventato
+44 1632 960123

Interpretare il risultato

Questo numero non è nel nostro database. Sii il primo a segnalarlo.

Questo numero ha segnalazioni di chiamate indesiderate

Limiti

Attenzione

Informazioni basate sulle segnalazioni della community e su analisi automatiche. Possono contenere errori o non essere aggiornate e non costituiscono consulenza legale né un'accusa verificata contro il titolare del numero.

Risoluzione dei problemi

Il controllo di sicurezza o la connessione all'API non ha risposto in tempo. Riprova tra qualche secondo.

Leggi i campi disponibili insieme ai loro limiti. Un risultato vuoto non dimostra sicurezza e non identifica una persona.

Usare con l’API

Attenzione

Richiede una API key e dei crediti. Ogni chiamata completata costa 1 credito, anche quando non ci sono dati. Un account Pro attivo include 20 crediti per mese solare UTC, condivisi da tutte le rotte API e consumati per primi; i crediti mensili non usati non passano al mese successivo. I crediti acquistati nella pagina del tuo account funzionano senza Pro e non scadono mai.

Nota

Gli errori non vengono mai addebitati: 401 invalid_api_key (chiave mancante o non valida), 403 pro_required (nessun credito Pro e nessun credito acquistato), 422 input non valido, 429 quota_exceeded (crediti esauriti), rate_limit_exceeded o ai_busy (l’IA di sms-check è al limite della capacità), 503 tool_warming (i dati sono ancora in preparazione) o tool o provider non disponibile. Dopo un 429 o un 503, riprova quando sono trascorsi i secondi indicati nell’intestazione Retry-After.

Statistiche pubbliche sullo spam di un paese, oppure i numeri elencati pubblicamente di una categoria, con paginazione. page × limit è limitato a 100.000 righe, come nella directory pubblica. Una cache fredda restituisce 503 tool_warming.

Invia il corpo JSON alla rotta specifica del tool, oppure a POST /v2/tools aggiungendo il campo tool. Entrambe le rotte restituiscono lo stesso risultato.

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}

Parametri

NomeTipoObbligatorioDescrizione
countrystring (enum, 56)No (predefinito: "ES")Codice paese di due lettere, ad esempio ES o US, usato per l’input nazionale e per i dati del paese.
category"TELEMARKETING" | "SCAM" | "DEBT" | "HARASSMENT" | "SURVEY" | "SPAM"NoCategoria di spam. Senza di essa viene restituito il riepilogo del paese e page e limit vengono ignorati. page × limit può essere al massimo 100.000.
pageinteger (1–10000)No (predefinito: 1)Numero di pagina, a partire da 1.
limitinteger (1–50)No (predefinito: 20)Risultati per pagina.
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}'

Esempio di risposta (200)

Questo è l’esempio documentato nel riferimento API. Le ricerche usano un numero fittizio, mentre aggregati e risposte dell’IA mostrano la struttura del risultato, non dati reali.

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

Campi del risultato (data.result)

CampoTipoDescrizione
view"summary" | "category""summary" senza categoria; "category" con una categoria.
totalsobjectTotali di numeri bloccati, segnalazioni e commenti.
categoriesarray<object>Numero di segnalazioni per categoria.
topReportedarray<object>I 20 numeri più segnalati (vista riepilogo), ciascuno con la data dell’ultima segnalazione in ISO 8601 UTC, oppure null.
category"TELEMARKETING" | "SCAM" | "DEBT" | "HARASSMENT" | "SURVEY" | "SPAM"La categoria mostrata (vista category).
totalintegerNumero totale di righe corrispondenti.
pageintegerPagina corrente.
limitintegerRighe per pagina.
hasMorebooleanSe restano altre righe dopo questa pagina.
rowsarray<object>Numeri elencati pubblicamente della categoria in questa pagina, ciascuno con la sua categoria e il numero di segnalazioni approvate (vista categoria).