Référence développeur

Liste Noire de Courrier

Consultez la documentation de l'API Liste Noire de Courrier, ses paramètres de requête, les champs de réponse, les exemples de code et la gestion des erreurs pour les intégrations DomScan.

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.

GET /v1/email/check

Paramètres de requête

ParamètreTypeDescription
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érifierDescriptionPoints 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

# 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
POST /v1/email/check/bulk

Corps de la requête

ParamètreTypeDescription
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
GET /v1/email/blacklist

Paramètres de requête

ParamètreTypeDescription
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
GET /v1/email/blacklist/download Crédits: 0

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 -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 OK
  • 401 Non autorisé
  • 429 Trop de requêtes