Liste Noire de Courrier
API de validation d'e-mails qui détecte les adresses e-mail jetables ou temporaires, les adresses de rôle et les fournisseurs gratuits, et vérifie la réputation du domaine. La base de données contient plus de 80 000 domaines d'e-mail jetables avec un score de confiance élevé, moyen ou faible. Utile pour prévenir la fraude à l'inscription et filtrer la qualité des prospects.
Paramètres de requête
Paramètre Type Description
email requis
string
Adresse de courrier à vérifier (par exemple, "[email protected] ")
checks optionnel
string
Vérifications séparées par des virgules à exécuter : disposable, role, free, mx, dnsbl. Par défaut : toutes
Vérifications disponibles
Vérifier Description Points de risque
disposableVérification par rapport à la base de données de 80 000+ domaines jetables +80
roleDétecte les adresses basées sur un rôle (admin@, support@, etc.) +20
freeIdentifie les fournisseurs de courrier électronique gratuits (gmail, yahoo, etc.) +10
mxValide que les enregistrements MX existent pour le domaine +50 (si aucun)
dnsblVérifie le domaine par rapport aux listes noires DNS (Spamhaus, etc.) +15-60
Niveaux de risque
Faible (0-39) :: Sûr à accepter
Moyen (40-69) :: Examen recommandé
Élevé (70-100) :: Probablement frauduleux/temporaire
Exemple de requête
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")
Exemple de réponse
{
"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"
}
Champs de réponse
Champ
Type
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
Corps de la requête
Paramètre Type Description
emails requis
string[]
Tableau d'adresses électroniques à vérifier (max 100 par requête)
checks optionnel
string[]
Vérifications à exécuter : ["jetable", "rôle", "gratuit", "mx", "dnsbl"]
Cas d'utilisation
Nettoyez les listes de courrier électronique avant les campagnes marketing
Validez les enregistrements d'utilisateurs en temps réel
Notez les prospects par qualité de courrier électronique
Détectez les modèles de fraude d'inscription
Exemple de requête
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"]
}'
Exemple de réponse
{
"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"
}
Champs de réponse
Champ
Type
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
Paramètres de requête
Paramètre Type Description
limit optionnel
number
Nombre de domaines à retourner (défaut : 1 000, max : 10 000)
offset optionnel
number
Décalage de pagination (par défaut : 0)
cursor optionnel
string
Le next_cursor de la page précédente. Voir la pagination .
format optionnel
string
json (par défaut) ou txt pour la liste en texte brut
Description
Téléchargez la liste noire des domaines d'e-mail jetables. Gratuit pour tous les utilisateurs. Utilisez /v1/email/blacklist/download pour la liste complète sous forme de fichier téléchargeable.
Exemple de requête
# 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
Exemple de réponse
{
"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"
]
}
}
Champs de réponse
Champ
Type
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
Paramètres de requête
Paramètre
Type
requis
format
string
Valeurs autorisées
jsontxt
Défaut
json
optionnel
Champs de réponse
Champ
Type
domains[]
string[]
wildcards[]
string[]
metadata
object
Exemple de requête
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))
Exemple de réponse {
"domains": [
"example.com",
"example.org"
],
"wildcards": [
"example"
],
"metadata": {}
}
Codes de statut HTTP
200 OK401 Non autorisé429 Trop de requêtes