Disposable Email Detection

Detect fake and disposable email addresses in real time. Block throwaway emails at signup, prevent free trial abuse, and reduce spam accounts. Returns risk score, MX record validity, and detailed reason codes.

原始信息汇总

Disposable Email Detection API 数据集概述

数据集基本信息

• 数据集名称: Disposable Email Detection
• 数据集类别: Email
• 数据集提供方: Blank
• 数据集地址: https://rapidapi.com/nothingblank37/api/disposable-email-detection4
• API 基础 URL: https://disposable-email-api-production.up.railway.app
• 当前版本: v1

数据集功能概述

该 API 帮助开发者在用户注册时实时拦截虚假和一次性电子邮件地址。

主要功能

• 检测超过 72,000 个已知的一次性电子邮件提供商（如 Mailinator, Guerrilla Mail, Temp-Mail 等）。
• 返回风险评分，范围从 0.0（安全）到 1.0（确定是一次性邮箱）。
• 识别基于角色的地址（如 noreply@, postmaster@, admin@）。
• 检查 MX 记录以验证域名是否可以实际接收电子邮件。
• 支持批量检查，每次调用最多可检查 500 个电子邮件（Starter/Pro 套餐）。

目标用户

• 防止免费试用滥用的 SaaS 创始人。
• 拦截虚假订阅者的新闻通讯工具。
• 减少垃圾账户的市场平台。
• 任何拥有注册表单的产品。

使用优势

• 单次 API 调用，响应时间低于 100 毫秒。
• 超过 72,000 个一次性域名每日更新。
• 返回简洁的 JSON 响应，包含风险评分和原因代码。
• 无需设置，可在 10 分钟内完成集成。

套餐与定价

套餐	价格	每日请求次数	批量检查	自定义规则
Basic	$0/月	100	否	否
Pro	$12/月	10,000	100/次	否
Ultra	$39/月	100,000	500/次	是

API 端点详情

GET /v1/check

检查单个电子邮件地址。

• 查询参数:
  • email (string, 必需): 要检查的电子邮件地址。
• 响应字段:
  • email (string): 标准化（小写）的电子邮件。
  • domain (string): 电子邮件的域名部分。
  • is_disposable (boolean): 如果地址是一次性的或没有 MX 记录，则为 true。
  • is_role_address (boolean): 对于 postmaster@, noreply@, admin@ 等，为 true。
  • risk_score (float): 风险评分，0.0（安全）到 1.0（确定是一次性邮箱）。
  • reason (string): 评分的首要原因。
  • mx_valid (boolean/null): 域名是否具有有效的 MX 记录。
  • checked_at (string): ISO 8601 时间戳。
• 原因值:
  • known_disposable_provider: 域名匹配超过 72,000 个已知提供商的共享阻止列表。
  • custom_rule_match: 域名匹配您的 Ultra 层级自定义规则。
  • suspicious_pattern: 本地部分或域名匹配启发式模式。
  • no_mx_record: 域名没有邮件交换器，无法接收电子邮件。
  • role_address: 基于角色的本地部分。
  • clean: 未检测到危险信号。
• 推荐阈值:
  • 风险评分 >= 0.80 时阻止。
  • 风险评分在 0.40 到 0.79 之间时标记为手动审核。
  • 风险评分低于 0.40 时允许。

POST /v1/check-bulk

批量检查多个电子邮件。仅限 Pro 和 Ultra 套餐。

• 请求体: { "emails": ["[e-mail]", "[e-mail]"] }
• 每次调用最大电子邮件数:
  • Pro: 100
  • Ultra: 500

GET /v1/domain/:domain

直接检查域名，无需本地部分。所有套餐可用。

GET /v1/plans

返回实时执行的套餐配置。无需认证。

GET /v1/usage

返回您当天的配额使用情况。需要认证。

POST /v1/rules · GET /v1/rules · DELETE /v1/rules/:domain

管理您的自定义域名阻止列表。仅限 Ultra 套餐。

速率限制

套餐	每日请求次数	每分钟请求次数	批量最大/次
Basic	100	10	N/A
Pro	10,000	60	100
Ultra	100,000	300	500

错误响应

所有错误均遵循以下结构： json { "error": { "code": "error_code", "message": "Error description." } }

域名列表

• 超过 72,000 个一次性域名，从三个开源来源汇总，每天 UTC 时间 03:00 自动刷新。
• Ultra 套餐用户可以通过 POST /v1/rules 添加自定义域名。自定义规则仅作用于您的 API 密钥，其他用户不可见。

安全特性

• API 密钥以 bcrypt 哈希存储。
• 所有 SQL 使用参数化查询。
• 每个响应都包含 Helmet.js 安全标头。
• 向客户端提供通用错误消息。
• 请求正文上限为 64kb。
• 发布前已识别并修复 13 个安全漏洞。