API für E-Mail-Blacklist
Überprüfen Sie, ob eine Domain oder IP auf E-Mail-Blacklisten aufgeführt ist. Nutzen Sie diese Referenz, um den passenden Endpunkt zu wählen und genau zu sehen, was er zurückgibt.
Operationen
GET /v1/email/check
GET
/v1/email/check
Credits: 1
Abfrageparameter
| Parameter | Typ | erforderlich |
|---|---|---|
| string | erforderlich | |
| checks | string | optional |
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 |
Beispielanfrage
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl"const response = await fetch("https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl", {
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/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl",
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/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl", 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/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl")
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
{
"email": "[email protected]",
"domain": "acme-widgets.com",
"local_part": "support",
"valid_syntax": true,
"checks": {
"disposable": {
"is_disposable": false,
"confidence": null
},
"role": {
"is_role": true,
"role_type": "support"
},
"free": {
"is_free": false,
"provider": null
},
"mx": {
"has_mx": true,
"records": [
"mx1.mailhost-example.net",
"mx2.mailhost-example.net"
]
},
"dnsbl": {
"listed": false,
"threat_level": "none"
}
},
"risk_score": 20,
"risk_level": "low",
"flags": [
"ROLE_ADDRESS"
],
"checked_at": "2026-10-09T10:15:30.000Z"
}
HTTP-Statuscodes
200OK400Ungültige Anfrage401Nicht autorisiert402Zahlung erforderlich429Zu viele Anfragen
POST /v1/email/check/bulk
POST
/v1/email/check/bulk
Credits: 1/item
Abfrageparameter
| Parameter | Typ | erforderlich |
|---|---|---|
| dry_run |
string
Zulässige Werte
true
|
optional |
Body-Parameter
| Parameter | Typ | erforderlich |
|---|---|---|
| emails | string[] | erforderlich |
| checks |
string[]
Zulässige Werte
disposablerolefreemxdnsbl
|
optional |
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 |
Beispielanfrage
curl -X POST "https://domscan.net/v1/email/check/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"emails": [
"[email protected]",
"[email protected]"
],
"checks": [
"disposable",
"role",
"mx"
]
}'const response = await fetch("https://domscan.net/v1/email/check/bulk", {
method: "POST",
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"emails": [
"[email protected]",
"[email protected]"
],
"checks": [
"disposable",
"role",
"mx"
]
}),
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.post(
"https://domscan.net/v1/email/check/bulk",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
json={
"emails": [
"[email protected]",
"[email protected]",
],
"checks": [
"disposable",
"role",
"mx",
],
},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"emails": [
"[email protected]",
"[email protected]"
],
"checks": [
"disposable",
"role",
"mx"
]
}`)
req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/email/check/bulk", body)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
req.Header.Set("Content-Type", "application/json")
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/check/bulk")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
"emails" => [
"[email protected]",
"[email protected]"
],
"checks" => [
"disposable",
"role",
"mx"
]
})
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
{
"results": [
{}
],
"summary": {
"total": 10,
"disposable": 3,
"role_based": 1,
"free_provider": 2,
"no_mx": 0,
"dnsbl_listed": 0,
"high_risk": 3,
"medium_risk": 1,
"low_risk": 6
},
"checked_at": "2026-08-27T12:00:00Z"
}
HTTP-Statuscodes
200OK400Ungültige Anfrage401Nicht autorisiert402Zahlung erforderlich409HTTP 409422HTTP 422429Zu viele Anfragen
GET /v1/email/blacklist
GET
/v1/email/blacklist
Credits: 0
Abfrageparameter
| Parameter | Typ | erforderlich |
|---|---|---|
| limit |
integer
Standard
1000
|
optional |
| offset |
integer
Standard
0
|
optional |
| format |
string
Zulässige Werte
jsontxt
Standard
json
|
optional |
| cursor | string | optional |
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 |
Beispielanfrage
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/blacklist?limit=25&offset=0&format=json"const response = await fetch("https://domscan.net/v1/email/blacklist?limit=25&offset=0&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?limit=25&offset=0&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?limit=25&offset=0&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?limit=25&offset=0&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": [
"0-00.usa.cc",
"0-180.com",
"0-30-24.com"
],
"total": 91331,
"offset": 0,
"limit": 3,
"metadata": {
"last_updated": "2026-10-09T03:00:07.499Z",
"total_domains": 91331,
"high_confidence_count": 5142,
"wildcard_count": 0,
"sources": [
"disposable-email-domains",
"fakefilter",
"mailchecker"
],
"source_count": 8,
"successful_source_count": 8,
"failed_source_count": 0,
"refresh_cadence_hours": 24,
"refresh_status": "fresh",
"next_refresh_due": "2026-10-10T03:00:07.499Z",
"dataset_status": "complete",
"quality_policy_version": 2,
"quarantined_domain_count": 0,
"rejected_domain_count": 0
}
}
HTTP-Statuscodes
200OK400Ungültige Anfrage401Nicht autorisiert429Zu viele Anfragen
GET /v1/email/blacklist/download
GET
/v1/email/blacklist/download
Credits: 0
Abfrageparameter
| Parameter | Typ | erforderlich |
|---|---|---|
| format |
string
Zulässige Werte
jsontxt
Standard
json
|
optional |
Antwortfelder
| Feld | Typ |
|---|---|
domains[] |
string[] |
wildcards[] |
string[] |
metadata |
object |
Beispielanfrage
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
200OK401Nicht autorisiert429Zu viele Anfragen