Lista nera di posta elettronica
API di convalida e-mail che rileva indirizzi e-mail usa e getta o temporanei, indirizzi basati su ruolo e provider gratuiti, e verifica la reputazione del dominio. Il database contiene oltre 80.000 domini e-mail usa e getta con punteggio di affidabilità alto, medio e basso. Utile per prevenire le frodi in fase di iscrizione e filtrare la qualità dei lead.
Parametri di query
Parametro Tipo Descrizione
email obbligatorio
string
Indirizzo email da verificare (ad es. "[email protected] ")
checks facoltativo
string
Controlli separati da virgole da eseguire: disposable, role, free, mx, dnsbl. Predefinito: tutti
Controlli disponibili
Verifica Descrizione Punti di rischio
disposableControlla rispetto a 80K+ database di dominio usa e getta +80
roleRileva indirizzi basati su ruolo (admin@, support@, ecc.) +20
freeIdentifica i provider di email gratuiti (gmail, yahoo, ecc.) +10
mxConvalida che i record MX esistano per il dominio +50 (se non presenti)
dnsblControlla il dominio rispetto alle liste nere DNS (Spamhaus, ecc.) +15-60
Livelli di rischio
Basso (0-39):: Sicuro da accettare
Medio (40-69):: Revisione consigliata
Alto (70-100):: Probabilmente fraudolento/temporaneo
Richiesta di esempio
cURL
Python
# Full check (all validations)
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/[email protected] "
# Quick disposable check only
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/[email protected] &checks=disposable"
import requests
domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})
response = domscan.get(
"https://domscan.net/v1/email/check",
params={"email": "[email protected] "}
)
data = response.json()
if data['risk_level'] == 'high':
print(f"Reject: {data['flags']}")
elif data['checks']['disposable']['is_disposable']:
print("Disposable email detected")
Risposta di esempio
{
"email": "[email protected] ",
"domain": "tempmail.com",
"local_part": "user",
"valid_syntax": true,
"checks": {
"disposable": {
"is_disposable": true,
"confidence": "high"
},
"role": {
"is_role": false,
"role_type": null
},
"free": {
"is_free": false,
"provider": null
},
"mx": {
"has_mx": true,
"records": ["mx.tempmail.com"]
},
"dnsbl": {
"listed": false,
"threat_level": "none"
}
},
"risk_score": 80,
"risk_level": "high",
"flags": ["DISPOSABLE_DOMAIN"],
"checked_at": "2025-01-15T12:00:00Z"
}
Campi della risposta
Campo
Tipo
email
string
domain
string
local_part
string
valid_syntax
boolean
checks
object
checks.disposable
object
checks.disposable.is_disposable
boolean
checks.disposable.confidence
string | null
checks.disposable.matched_pattern
string
checks.role
object
checks.role.is_role
boolean
checks.role.role_type
string | null
checks.free
object
checks.free.is_free
boolean
checks.free.provider
string | null
checks.mx
object
checks.mx.has_mx
boolean | null
checks.mx.records[]
string[]
checks.mx.null_mx
boolean
checks.dnsbl
object
checks.dnsbl.domain
string
checks.dnsbl.ip
string
checks.dnsbl.listed
boolean
checks.dnsbl.lists[]
object[]
checks.dnsbl.lists[]
object
checks.dnsbl.lists[].name
string
checks.dnsbl.lists[].listed
boolean
checks.dnsbl.lists[].status
string
checks.dnsbl.lists[].code
string
checks.dnsbl.lists[].meaning
string
checks.dnsbl.lists[].unknown_reason
string
checks.dnsbl.lists_unknown
integer
checks.dnsbl.threat_level
string
checks.dnsbl.check_type
string
checks.dnsbl.checked_at
string
risk_score
integer
risk_level
string
flags[]
string[]
checked_at
string
Corpo della richiesta
Parametro Tipo Descrizione
emails obbligatorio
string[]
Array di indirizzi email da controllare (max 100 per richiesta)
checks facoltativo
string[]
Controlli da eseguire: ["disposable", "role", "free", "mx", "dnsbl"]
Casi d'uso
Pulisci elenchi email prima di campagne di marketing
Convalida le registrazioni degli utenti in tempo reale
Valuta i lead in base alla qualità della email
Rileva i modelli di frode di iscrizione
Richiesta di esempio
curl -H "X-API-Key: your-api-key" -X POST "https://domscan.net/v1/email/check/bulk" \
-H "Content-Type: application/json" \
-d '{
"emails": [
"[email protected] ",
"[email protected] ",
"[email protected] "
],
"checks": ["disposable", "role"]
}'
Risposta di esempio
{
"results": [
{
"email": "[email protected] ",
"risk_level": "low",
"risk_score": 10,
"flags": ["FREE_PROVIDER"]
},
{
"email": "[email protected] ",
"risk_level": "high",
"risk_score": 80,
"flags": ["DISPOSABLE_DOMAIN"]
},
{
"email": "[email protected] ",
"risk_level": "medium",
"risk_score": 20,
"flags": ["ROLE_ADDRESS"]
}
],
"summary": {
"total": 3,
"disposable": 1,
"role_based": 1,
"free_provider": 1,
"high_risk": 1,
"medium_risk": 1,
"low_risk": 1
},
"checked_at": "2025-01-15T12:00:00Z"
}
Campi della risposta
Campo
Tipo
results[]
object[]
results[]
object
summary
object
summary.total
integer
summary.disposable
integer
summary.role_based
integer
summary.free_provider
integer
summary.no_mx
integer
summary.dnsbl_listed
integer
summary.high_risk
integer
summary.medium_risk
integer
summary.low_risk
integer
checked_at
string
Parametri di query
Parametro Tipo Descrizione
limit facoltativo
number
Numero di domini da restituire (default: 1000, max: 10000)
offset facoltativo
number
Offset di paginazione (default: 0)
cursor facoltativo
string
Il next_cursor della pagina precedente. Vedi la paginazione .
format facoltativo
string
json (default) o txt per elenco di testo semplice
Descrizione
Scarica la blacklist dei domini e-mail usa e getta. Gratuita per tutti gli utenti. Usa /v1/email/blacklist/download per l'elenco completo come file scaricabile.
Richiesta di esempio
# Get first 1000 domains as JSON
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist"
# Get as plain text for firewall rules
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist?format=txt&limit=5000"
# Download complete blacklist
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist/download" -o disposable.json
Risposta di esempio
{
"domains": [
"tempmail.com",
"guerrillamail.com",
"10minutemail.com",
"mailinator.com",
"..."
],
"total": 85432,
"offset": 0,
"limit": 1000,
"metadata": {
"last_updated": "2025-01-15T00:00:00Z",
"total_domains": 85432,
"high_confidence_count": 12500,
"wildcard_count": 234,
"sources": [
"disposable-email-domains",
"ivolo/disposable-email-domains"
]
}
}
Campi della risposta
Campo
Tipo
has_more
boolean
next_cursor
string | null
domains[]
string[]
total
integer
offset
integer
limit
integer
metadata
object
metadata.last_updated
string
metadata.total_domains
integer
metadata.high_confidence_count
integer
metadata.wildcard_count
integer
metadata.sources[]
string[]
metadata.source_count
integer
metadata.successful_source_count
integer
metadata.failed_source_count
integer
metadata.refresh_cadence_hours
integer
metadata.refresh_status
string
metadata.next_refresh_due
string
metadata.dataset_status
string
metadata.quality_policy_version
integer | null
metadata.quarantined_domain_count
integer
metadata.rejected_domain_count
integer
Parametri di query
Parametro
Tipo
obbligatorio
format
string
Valori consentiti
jsontxt
Predefinito
json
facoltativo
Campi della risposta
Campo
Tipo
domains[]
string[]
wildcards[]
string[]
metadata
object
Richiesta di esempio
cURL Node.js Python Go Ruby
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/blacklist/download?format=json"const response = await fetch("https://domscan.net/v1/email/blacklist/download?format=json", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/email/blacklist/download?format=json",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/email/blacklist/download?format=json", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/email/blacklist/download?format=json")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))
Risposta di esempio {
"domains": [
"example.com",
"example.org"
],
"wildcards": [
"example"
],
"metadata": {}
}
Codici di stato HTTP
200 OK401 Non autorizzato429 Troppe richieste