E-Mail-Blacklist
API zur E-Mail-Validierung, die Wegwerf- oder temporäre E-Mail-Adressen, rollenbasierte Adressen und kostenlose Anbieter erkennt und die Domain-Reputation prüft. Die Datenbank enthält über 80.000 Wegwerf-E-Mail-Domains mit hoher, mittlerer und niedriger Vertrauensbewertung. Nützlich zur Verhinderung von Anmeldebetrug und zur Filterung der Lead-Qualität.
Abfrageparameter
Parameter Typ Beschreibung
email erforderlich
string
E-Mail-Adresse zur Überprüfung (z. B. "[email protected] ")
checks optional
string
Komma-getrennte Überprüfungen: disposable, role, free, mx, dnsbl. Standard: alle
Verfügbare Prüfungen
Prüfen Beschreibung Risikopunkte
disposablePrüfung gegen 80.000+ Einweg-Domain-Datenbank +80
roleErkennt rollenbasierte Adressen (admin@, support@ usw.) +20
freeIdentifiziert kostenlose E-Mail-Provider (gmail, yahoo usw.) +10
mxValidiert, dass MX-Einträge für Domain vorhanden sind +50 (falls keine vorhanden sind)
dnsblÜberprüft Domain gegen DNS-Blacklisten (Spamhaus usw.) +15-60
Risikostufen
Niedrig (0-39):: Sicher zu akzeptieren
Mittel (40-69):: Überprüfung empfohlen
Hoch (70-100):: Wahrscheinlich Betrug/Einweg
Beispielanfrage
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")
Beispielantwort
{
"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"
}
Antwortfelder
Feld
Typ
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
Anfragetext
Parameter Typ Beschreibung
emails erforderlich
string[]
Array von E-Mail-Adressen zum Prüfen (max. 100 pro Anfrage)
checks optional
string[]
Auszuführende Prüfungen: ["disposable", "role", "free", "mx", "dnsbl"]
Anwendungsfälle
Bereinigen Sie E-Mail-Listen vor Marketing-Kampagnen
Validieren Sie Benutzerregistrierungen in Echtzeit
Bewerten Sie Leads nach E-Mail-Qualität
Erkennen Sie Anmelde-Betrugsmuster
Beispielanfrage
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"]
}'
Beispielantwort
{
"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"
}
Antwortfelder
Feld
Typ
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
Abfrageparameter
Parameter Typ Beschreibung
limit optional
number
Anzahl der zurückzugebenden Domains (Standard: 1.000, Maximum: 10.000)
offset optional
number
Pagination-Offset (Standard: 0)
cursor optional
string
Das next_cursor der vorherigen Seite. Siehe Pagination .
format optional
string
json (Standard) oder txt für Klartext-Liste
Beschreibung
Laden Sie die Blacklist für Wegwerf-E-Mail-Domains herunter. Kostenlos für alle Nutzer. Verwenden Sie /v1/email/blacklist/download für die vollständige Liste als herunterladbare Datei.
Beispielanfrage
# 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
Beispielantwort
{
"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"
]
}
}
Antwortfelder
Feld
Typ
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
Abfrageparameter
Parameter
Typ
erforderlich
format
string
Zulässige Werte
jsontxt
Standard
json
optional
Antwortfelder
Feld
Typ
domains[]
string[]
wildcards[]
string[]
metadata
object
Beispielanfrage
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))
Beispielantwort {
"domains": [
"example.com",
"example.org"
],
"wildcards": [
"example"
],
"metadata": {}
}
HTTP-Statuscodes
200 OK401 Nicht autorisiert429 Zu viele Anfragen