11月19日(周四)07:00–13:30 UTC 期间进行维护:我们的核心 API 将在维护期间的某个时间段内暂停服务 30 分钟至 2 小时。请查看 API 状态页面以获取实时更新。对于未能及时通知给您带来的不便,我们深表歉意。查看状态页面

服务细则

可提供有效地身份验证,从路径访问数据库文件。用户名和密码为个人的API密钥,可从我的产品页面获取。

数据库有以下几种形式。

  • 已评分的电子邮件域:每日更新的电子邮件域列表,包含 0-100 的置信度评分、分类、是否已查看 MX 记录的指示符以及上次 MX 检查的日期。
    • 分类等级:一次性(92–100) ,可能一次性(62–92) ,未知(42–62) ,自由(0–42) 。
    • 基本路径: https://download.whoisxmlapi.com/datafeeds
    • 格式: “disposable-emails-scored.full.%DATE%.csv”和“disposable-emails-scored.full.%DATE%.json” ,例如“disposable-emails-scored.full.2026-07-28.csv” 。
    • 每天 13:00 UTC 都会有一个新文件可供下载。
    • 示例: disposable-emails-scored.full.2026-07-28.sample.csv 、 disposable-emails-scored.full.2026-07-28.sample.json
    • 文件字段:

      JSON 文件以驼峰命名法包含相同的字段: domain 、 confidenceScore 、 classification 、 mxSeen 、 mxChecked 、 modelVersion 。

      场地 类型 描述
      领域 细绳 域名,小写。国际化域名使用 Punycode (xn--) 。
      置信度得分 整数, 0-100 模型对域名是否可弃用进行置信度评估。数值越高,表示域名越有可能可弃用。对于域名服务器永久无响应的少量残留域名(约占 0.1%),该模型为空。
      分类 细绳 “一次性”、 “可能一次性” 、“免费”、“未知”之一。
      mx_seen 布尔值 上次检查时是否检测到邮件基础设施正常运行。空表示未建立,并非“没有邮件服务器”。
      mx_checked 日期 上次检查 MX 存活时间的时间,采用标准格式(YYYY-mm-dd) ,例如2026-07-22 。
      模型版本 细绳 生成该分数的评分模型的指纹。对于尚未根据已盖章模型重新评分的行,此部分为空。
  • 一次性电子邮件域名:每日更新的一次性电子邮件域名列表。
  • 免费电子邮件域名:每日更新的免费电子邮件域名列表。

如何下载数据源文件

推荐的解压缩工具

处理大型压缩文件时,我们建议使用unpigz而不是gunzip 。根据我们的性能测试, gunzip处理大型文件的速度几乎是unpigz的两倍。因此, unpigz是首选的解压缩工具。

通过HTTPS下载

注意:如果您的帐户设置中启用了IP 允许列表,则仅接受来自列出的 IP 地址的 HTTPS 下载;其他请求将被拒绝,并显示403“您的 IP 地址不在允许列表中” 。

通过FTP下载

注意:如果您的帐户设置中启用了IP 地址白名单,则该白名单不仅适用于 API 调用,也适用于数据源下载:来自不在白名单中的 IP 地址的 FTP、FTPS 和 HTTPS 请求将被拒绝,并返回403 错误“您的 IP 地址不在白名单中” 。启用白名单前,请将所有下载数据源的计算机的 IP 地址添加到白名单中。

通过FTPS下载

了解更多关于FTPS连接的相关信息:https://en.wikipedia.org/wiki/FTPS。

我们的FTP服务器支持通过TLS加密的形式显式FTP。您可将您的FTP客户端配置为“explicit FTP over TLS"的方式进行加密安全通信。

我们的FTPS服务器与普通FTP服务器可使用相同的路径和API密钥进行访问。说明详见上文。 如您的FTP客户端支持,且想通过FTPS连接,请选择 "要求explicit FTP over TLS"加密选项。FileZilla配置示例:

通过TLS加密的显式FTP