Чёрный список электронной почты
API проверки электронной почты, который обнаруживает одноразовые или временные адреса электронной почты, адреса на основе ролей и бесплатных провайдеров, а также проверяет репутацию домена. База данных содержит 80 000+ доменов одноразовой электронной почты с оценкой достоверности: высокая, средняя и низкая. Полезно для предотвращения мошенничества при регистрации и фильтрации лидов по качеству.
Параметры запроса
Параметр Тип Description
email обязателен
string
Описание
checks опционально
string
Проверки, разделённые запятыми, для запуска: disposable, role, free, mx, dnsbl. По умолчанию: все
Доступные проверки
Проверить Description Баллы риска
disposableПроверяет по базе данных 80K+ одноразовых доменов +80
roleОбнаруживает адреса на основе ролей (admin@, support@ и т. д.) +20
freeОпределяет бесплатные поставщиков электронной почты (gmail, yahoo и т. д.) +10
mxПроверяет наличие MX записей для домена +50 (если нет)
dnsblПроверяет домен по чёрным спискам DNS (Spamhaus и т. д.) +15-60
Уровни риска
Низкий (0-39):: Безопасно принять
Средний (40-69):: Рекомендуется проверка
Высокий (70-100):: Вероятно мошеннический/временный
Пример запроса
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")
Пример ответа
{
"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"
}
Поля ответа
Поле
Тип
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
Тело запроса
Параметр Тип Description
emails обязателен
string[]
Массив адресов электронной почты для проверки (максимум 100 за запрос)
checks опционально
string[]
Проверки для запуска: ["disposable", "role", "free", "mx", "dnsbl"]
Сценарии использования
Очистите списки электронной почты перед маркетинговыми кампаниями
Проверьте пользовательские регистрации в реальном времени
Оцените потенциальные клиенты по качеству электронной почты
Обнаружьте закономерности мошенничества при регистрации
Пример запроса
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"]
}'
Пример ответа
{
"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"
}
Поля ответа
Поле
Тип
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
Параметры запроса
Параметр Тип Description
limit опционально
number
Количество возвращаемых доменов (по умолчанию: 1000, максимум: 10000)
offset опционально
number
Смещение постраничной разбивки (по умолчанию: 0)
cursor опционально
string
Значение next_cursor с предыдущей страницы. См. постраничную навигацию .
format опционально
string
json (по умолчанию) или txt для простого текстового списка
Description
Загрузите чёрный список доменов одноразовой электронной почты. Бесплатно для всех пользователей. Используйте /v1/email/blacklist/download для полного списка в виде загружаемого файла.
Пример запроса
# 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
Пример ответа
{
"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"
]
}
}
Поля ответа
Поле
Тип
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
Параметры запроса
Параметр
Тип
обязателен
format
string
Допустимые значения
jsontxt
По умолчанию
json
опционально
Поля ответа
Поле
Тип
domains[]
string[]
wildcards[]
string[]
metadata
object
Пример запроса
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))
Пример ответа {
"domains": [
"example.com",
"example.org"
],
"wildcards": [
"example"
],
"metadata": {}
}
Коды состояния HTTP
200 OK401 Не авторизован429 Слишком много запросов