Riferimento per sviluppatori

Lista nera di posta elettronica

Consulta la documentazione API di Lista nera di posta elettronica, i parametri delle richieste, i campi delle risposte, gli esempi di codice e la gestione degli errori per le integrazioni DomScan.

Lista nera di posta elettronica

API completa di convalidazione della posta elettronica per rilevare indirizzi di posta elettronica usa e getta/temporanei, indirizzi basati su ruoli, provider gratuiti e verificare la reputazione del dominio. Il nostro database contiene 80.000+ domini di posta elettronica usa e getta con punteggio di confidenza alto/medio/basso. Essenziale per la prevenzione delle frodi di iscrizione e il filtraggio della qualità dei lead.

GET /v1/email/check

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
`disposable`	Controlla rispetto a 80K+ database di dominio usa e getta	+80
`role`	Rileva indirizzi basati su ruolo (admin@, support@, ecc.)	+20
`free`	Identifica i provider di email gratuiti (gmail, yahoo, ecc.)	+10
`mx`	Convalida che i record MX esistano per il dominio	+50 (se non presenti)
`dnsbl`	Controlla 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

# 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 di 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.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
`checks.mx.records[]`	string[]
`checks.dnsbl`	object
`checks.dnsbl.listed`	boolean
`checks.dnsbl.threat_level`	string
`risk_score`	integer
`risk_level`	string
`flags[]`	string[]
`checked_at`	string

POST /v1/email/check/bulk

Corpo 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 di 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

GET /v1/email/blacklist

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)
format facoltativo	string	`json` (default) o `txt` per elenco di testo semplice

Descrizione

Scarica la nostra lista nera di dominio email usa e getta. Gratuito 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 di risposta

Campo	Tipo
`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

GET /v1/email/blacklist/download

Parametri di query

Parametro	Tipo	obbligatorio
format	string Valori consentiti `jsontxt` Predefinito `json`	facoltativo

Campi di risposta

Campo	Tipo
`domains[]`	string[]
`wildcards[]`	string[]
`metadata`	object

Richiesta di esempio

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/blacklist/download?format=json"

Risposta di esempio

{
  "domains": [
    "example.com",
    "example.org"
  ],
  "wildcards": [
    "example"
  ],
  "metadata": {}
}