电子邮件黑名单 API 参考

Q: 在哪里可以找到 电子邮件黑名单 的请求和响应参考？

使用 电子邮件黑名单 的 API 参考来查看参数、响应字段、示例、状态码和支持的操作模式。

你将获得什么

检查域名或 IP 是否列在电子邮件黑名单上。

同步批量RESTMCPSDK交互式工具

适合选择此产品的场景

适用对象

使用范围明确的被动检查来补充分诊和调查，而不是替代授权测试或人工审查。

适合选择此产品的场景

需要检查某一时间点的支持黑名单证据时选择。干净结果不是普遍信誉保证。

你将获得什么

检查域名或 IP 是否列在电子邮件黑名单上。

端点

集成前，请查看支持的操作、输入、输出、执行模式和响应限制。

GET /v1/email/check 查看 API 参考

POST /v1/email/check/bulk 查看 API 参考

GET /v1/email/blacklist 查看 API 参考

GET /v1/email/blacklist/download 查看 API 参考

积分和身份验证

0-1 需要身份验证。有关确切费用和按项计费，请查看操作参考。

操作示例

使用文档化的操作来收集、评估、补充、验证、比较、保护或监测公开证据。

GET /v1/email/check

查询参数

参数	类型	必需
email	string	必需
checks	string	可选

响应字段

字段	类型
`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.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
`checks.mx.records[]`	string[]
`checks.dnsbl`	object
`checks.dnsbl.listed`	boolean
`checks.dnsbl.threat_level`	string
`risk_score`	integer
`risk_level`	string
`flags[]`	string[]
`checked_at`	string

请求示例

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl"

响应示例

{
  "email": "[email protected]",
  "domain": "tempmail.org",
  "local_part": "user",
  "valid_syntax": true,
  "checks": {
    "disposable": {
      "is_disposable": true,
      "confidence": "high"
    },
    "role": {
      "is_role": false,
      "role_type": "domain"
    },
    "free": {
      "is_free": false,
      "provider": "example"
    },
    "mx": {
      "has_mx": true,
      "records": [
        "mx1.tempmail.org"
      ]
    },
    "dnsbl": {
      "listed": false,
      "threat_level": "none"
    }
  },
  "risk_score": 80,
  "risk_level": "high",
  "flags": [
    "DISPOSABLE_DOMAIN"
  ],
  "checked_at": "2026-08-27T12:00:00Z"
}