> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/de/docs/email-blacklist

# E-Mail-Blacklist

Entdecken Sie die API-Dokumentation zu E-Mail-Blacklist, Anfrageparameter, Antwortfelder, Codebeispiele und Fehlerbehandlung für DomScan-Integrationen.

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.

GET /v1/email/check

#### Abfrageparameter

| Parameter | Typ | Beschreibung |
| --- | --- | --- |
| email erforderlich | string | E-Mail-Adresse zur Überprüfung (z. B. "user@tempmail.com") |
| checks optional | string | Komma-getrennte Überprüfungen: `disposable`, `role`, `free`, `mx`, `dnsbl`. Standard: alle |

#### Verfügbare Prüfungen

| Prüfen | Beschreibung | Risikopunkte |
| --- | --- | --- |
| `disposable` | Prüfung gegen 80.000+ Einweg-Domain-Datenbank | +80 |
| `role` | Erkennt rollenbasierte Adressen (admin@, support@ usw.) | +20 |
| `free` | Identifiziert kostenlose E-Mail-Provider (gmail, yahoo usw.) | +10 |
| `mx` | Validiert, 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

```bash
# Full check (all validations)
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/check?email=user@tempmail.com"

# Quick disposable check only
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/check?email=user@gmail.com&checks=disposable"
```

```python
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": "user@tempmail.com"}
)
data = response.json()

if data['risk_level'] == 'high':
    print(f"Reject: {data['flags']}")
elif data['checks']['disposable']['is_disposable']:
    print("Disposable email detected")
```

#### Beispielantwort

```json
{
  "email": "user@tempmail.com",
  "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 |

POST /v1/email/check/bulk

#### 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

```bash
curl -H "X-API-Key: your-api-key" -X POST "https://domscan.net/v1/email/check/bulk" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "user@gmail.com",
      "test@tempmail.org",
      "admin@company.com"
    ],
    "checks": ["disposable", "role"]
  }'
```

#### Beispielantwort

```json
{
  "results": [
    {
      "email": "user@gmail.com",
      "risk_level": "low",
      "risk_score": 10,
      "flags": ["FREE_PROVIDER"]
    },
    {
      "email": "test@tempmail.org",
      "risk_level": "high",
      "risk_score": 80,
      "flags": ["DISPOSABLE_DOMAIN"]
    },
    {
      "email": "admin@company.com",
      "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 |

GET /v1/email/blacklist

#### 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](https://domscan.net/docs/response-format#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

```bash
# 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

```json
{
  "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 |

GET /v1/email/blacklist/download Credits: 0

#### Abfrageparameter

| Parameter | Typ | erforderlich |
| --- | --- | --- |
| format | string Zulässige Werte `json`, `txt` Standard `json` | optional |

#### Antwortfelder

| Feld | Typ |
| --- | --- |
| `domains[]` | string[] |
| `wildcards[]` | string[] |
| `metadata` | object |

#### Beispielanfrage

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

```javascript
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);
```

```python
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())
```

```go
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))
}
```

```ruby
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

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

#### HTTP-Statuscodes

- `200` OK
- `401` Nicht autorisiert
- `429` Zu viele Anfragen
