电子邮件黑名单API

分类安全

API 端点 4

主要功能 8

常见问题解答 5

被出色公司的人们使用

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

99.99% 可用性

面向生产的端点按 99.99% 可用性和已记录的状态处理方式设计。

OpenAPI API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

10,000 免费额度

从每月 10,000 积分开始，只有在用量增长时再升级。

这个 API 可以帮你交付什么

把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。

产品工作流

把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。

分析自动化

用计划任务、告警和可复现的调查步骤替代重复的人工查询。

干净的 JSON 数据

使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。

AI 和运维工具

通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。

集成流程

从第一次请求到可重复生产使用的简单路径。

一次认证

使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。

用示例查询

从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。

运行和监控

使用状态码、积分成本和响应字段构建重试、日志和告警。

开发者工具包

从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。

OpenAPI 架构

生成客户端，或检查每种请求和响应结构。

Postman 集合

导入现成请求，用于手动测试和团队交接。

SDK 和 CLI

使用维护中的包和命令行流程，避免编写样板代码。

MCP 集成

把域名情报暴露给 AI 代理和内部助手工作流。

参数和响应映射

在把端点接入客户端前，快速查看输入、输出字段和状态码。

请求参数

参数

emailtargetsformat

响应字段

响应示例

emaildomainlocal_partvalid_syntaxcheckschecks.disposablechecks.disposable.is_disposablechecks.disposable.confidencechecks.rolechecks.role.is_rolechecks.role.role_typechecks.free

状态覆盖

HTTP 状态码

200400402429500502503504

API 端点

GET /v1/email/check

积分: 1身份验证: 可选

POST /v1/email/check/bulk

积分: 1身份验证: 可选

targets

GET /v1/email/blacklist

积分: 0身份验证: 可选

GET /v1/email/blacklist/download

积分: 0身份验证: 可选

format

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

可用性 API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

免费额度 免费注册

从每月 10,000 积分开始，只有在用量增长时再升级。

活跃请求示例

从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。

主要功能

186K+一次性域名

从5个开源存储库聚合的综合数据库，每天更新。

置信度评分

基于跨源验证的高、中、低置信度级别。

基于角色的检测

识别admin@、support@、info@和其他基于角色的地址。

免费提供商检测

标记Gmail、Yahoo、Outlook和其他免费电子邮件提供商。

MX记录验证

验证域名是否真的可以接收电子邮件。

DNSBL检查

检查域名是否在Spamhaus、SURBL和URIBL黑名单上。

风险评分

0-100汇总风险评分，具有低/中/高分类。

批量API

在单个API请求中检查最多100个电子邮件，包括摘要统计。

请求示例

GET /v1/email/check bash

打开

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/check?email=user@10minutemail.com"

响应示例

200 OK json

{
  "email": "user@10minutemail.com",
  "domain": "10minutemail.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": ["mx1.10minutemail.com"] },
    "dnsbl": { "listed": false, "lists": [], "threat_level": "none" }
  },
  "risk_score": 80,
  "risk_level": "high",
  "flags": ["DISPOSABLE_DOMAIN"],
  "checked_at": "2026-03-29T18:00:00.000Z"
}

常见问题解答

什么是一次性电子邮件？

一次性电子邮件（也称为临时、临时或一次性使用电子邮件）是在短时间后自毁的地址。10minutemail、guerrillamail和tempmail等服务通常用于绕过注册验证。

我为什么应该阻止一次性电子邮件？

使用一次性电子邮件的用户参与度接近零，通常会滥用您的服务。阻止它们可以提高注册质量、减少虚假账户并节省电子邮件发送成本。

黑名单多久更新一次？

我们的数据库每天更新。通过GET /v1/email/blacklist访问完整列表。

我可以访问完整的黑名单吗？

是的！使用GET /v1/email/blacklist获取分页提要，每个请求最多10,000个域名。包括offset和limit参数以分页浏览完整列表。

风险评分基于什么？

一次性域名（+80）、无MX记录（+50）、DNSBL列出（+60）、基于角色的地址（+20）、免费提供商（+10）。评分上限为100，分类为低（0-39）、中（40-69）或高（70-100）。

HTTP 状态码

我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

成功 200

请求成功

请求错误 400

参数无效

需要付款 402

没有足够额度来执行此请求。

请求过多 429

超出速率限制

服务器错误 500

内部错误

网关错误 502

上游 RDAP 错误

服务不可用 503

上游服务不可用或正在临时限流。

网关超时 504

上游查询已超时。

开始阻止一次性电子邮件

查看完整 API 文档 API 接口

集成前可见的信任信号

这个 API 可以帮你交付什么

集成流程

开发者工具包

参数和响应映射

API 端点

集成前可见的信任信号

主要功能

请求示例

响应示例

常见问题解答

相关工具和资源

HTTP 状态码