📡 API notruffa.it

API REST gratuita per verificare numeri di telefono, URL ed email sospette. Gratuita REST / JSON 30 req/ora

Endpoint

GET https://notruffa.it/api.php?q={termine}

Verifica se un numero di telefono, URL o email è associato a truffe note.

Parametri

Parametro	Tipo	Obbligatorio	Descrizione
`q`	string	✅ Sì	Il termine da verificare: numero di telefono, URL, email o testo libero. Max 500 caratteri.

Risposta JSON

{
  "query":           "3291994657",       // termine cercato
  "trovato":         true,               // true se in blacklist
  "stato":           "confermata",       // confermata | sospetto | sicuro | non_trovato
  "livello_rischio": "alto",             // alto | medio | null
  "tipo_truffa":     "Truffa telefonica", // categoria truffa
  "descrizione":     "Numero segnalato...",
  "fonte":           "AbuseIPDB",        // fonte del dato
  "tipo_input":      "telefono",         // telefono | url | email | testo
  "generated_at":   "2026-06-04T20:00:00+02:00"
}

Valori di `stato`

Valore	Significato
`confermata`	🔴 Truffa confermata in blacklist internazionale
`sospetto`	🟡 Trovato in alcune blacklist parziali — procedere con cautela
`sicuro`	🟢 Dominio ufficiale riconosciuto come sicuro
`non_trovato`	🟢 Nessuna corrispondenza trovata

Codici di errore

HTTP	Messaggio	Causa
400	`Parametro q obbligatorio`	Richiesta senza parametro `q`
429	`Rate limit superato`	Più di 30 richieste nell'ultima ora

Limiti

Massimo 30 richieste per ora per IP. Per utilizzi intensivi contattaci.

L'API è gratuita e non richiede chiave di accesso. I dati sono aggiornati quotidianamente.

Esempi di codice

JavaScript

PHP

Python

cURL

const res  = await fetch('https://notruffa.it/api.php?q=3291994657');
const data = await res.json();

if (data.stato === 'confermata') {
  console.log('⚠️ TRUFFA:', data.tipo_truffa);
} else {
  console.log('✅ Non trovato');
}

$q    = '3291994657';
$url  = 'https://notruffa.it/api.php?q=' . urlencode($q);
$json = file_get_contents($url);
$data = json_decode($json, true);

if ($data['stato'] === 'confermata') {
    echo '⚠️ Truffa: ' . $data['tipo_truffa'];
} else {
    echo '✅ Non trovato';
}

import requests

r    = requests.get('https://notruffa.it/api.php', params={'q': '3291994657'})
data = r.json()

if data['stato'] == 'confermata':
    print(f"⚠️ Truffa: {data['tipo_truffa']}")
else:
    print("✅ Non trovato")

curl "https://notruffa.it/api.php?q=3291994657"

Prova subito

Link utili

← Torna a notruffa.it | 📊 Statistiche | 📋 Catalogo truffe