Email Tools API
Email Tools 验证 API
验证邮箱地址的可送达性:返回状态结论(good、risky 或 bad),以及域名、邮箱、catch-all、一次性邮箱和角色邮箱信号和一个置信度分数。格式错误的地址会被输入 schema 拒绝,不扣费;每个语法有效的地址都会返回一个扣费的结论,包括无法送达的地址。
POST/v1/run/email.verify
可用率
100.00%
30d · 1,968 次调用
请求数
1,968
30d · 按周,近 12 周
响应时间
5.0s
中位数 · 30d
服务商网络
按流量排序的服务商
试一试
发出你的第一个请求
requireFieldsarray可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `reason`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个结果确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"items": [
{
"catchAll": true,
"disposable": true,
"domain": "example.com",
"email": "alex@example.com",
"free": true,
"mxProvider": "a1b2c3d4",
"mxRecords": [
"example"
],
"reason": "example",
"role": true,
"score": 5,
"status": "active"
}
]
},
"found": true,
"reason": "not_found"
}响应类型定义
interface EmailVerifyResponse {
data: {
items: {
catchAll?: boolean;
disposable?: boolean;
domain?: string;
email: string;
free?: boolean;
mxProvider?: string | null;
mxRecords?: string[];
reason?: string;
role?: boolean;
score?: number;
status: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/email.verify
curl -X POST https://api.getanyapi.com/v1/run/email.verify \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"patrick@stripe.com"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| string | "patrick@stripe.com"要验证的邮箱地址(例如 jane.doe@acme.com)。必须恰好有一个 @、一个带点的域名,且不含空白字符或尖括号。使用保留的、永远无法送达的顶级域名(.invalid、.test、.example、.localhost、.local、.internal、.blink)的地址,以及 HTML/JSON 转义残留(u003e 前缀),会在本地被拒绝,不扣费。 | |
| requireFields | array | 可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `reason`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个结果确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。 |
| 响应 | ||
| data | object | |
| data.items | object[] | Verification records: the email address with its deliverability verdict and the domain, mailbox, and reputation signals behind it. A record is returned for every syntactically valid address, including ones the verdict marks undeliverable. Populated whenever the provider has data for the entity. |
| data.items[].catchAll | boolean | Domain accepts all addresses. |
| data.items[].disposable | boolean | |
| data.items[].domain | string | |
| data.items[].email | string | Populated whenever the provider has data for the entity. |
| data.items[].free | boolean | Free email provider. |
| data.items[].mxProvider可设为必填 | string | Mail provider behind the address domain, e.g. Google. Null when the serving source does not report one. |
| data.items[].mxRecords | string[] | MX record hosts published by the address domain. |
| data.items[].reason可设为必填 | string | Why the verdict was reached. Published by only one of the two sources, so it is absent on most calls; never treat it as required. |
| data.items[].role | boolean | Role-based address (e.g. info@). |
| data.items[].score | integer | Confidence in the verdict, 0-100. Coarse rather than graded on most calls: it tracks the status rather than ranking addresses within one. |
| data.items[].status | string | Deliverability verdict: good (the mailbox accepted), bad (it was refused), or risky (no source could settle it - usually a catch-all domain that accepts every address, sometimes a receiving server that declined to answer at all). Populated whenever the provider has data for the entity. |
| found | boolean | |
| reason可设为必填 | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| 价格 | ||
| 每次请求价格 | USD | US$0.0066 |
| 价格(/千次请求) | USD | US$6.60 |
常见问题
关于 Email Tools 验证 API
AnyAPI 的 Email Tools 验证 API 只需一次 POST 请求 /v1/run/email.verify,就以统一格式的 JSON 返回 Email Tools 数据。验证邮箱地址的可送达性:返回状态结论(good、risky 或 bad),以及域名、邮箱、catch-all、一次性邮箱和角色邮箱信号和一个置信度分数。格式错误的地址会被输入 schema 拒绝,不扣费;每个语法有效的地址都会返回一个扣费的结论,包括无法送达的地址。AnyAPI 会在 2 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$6.60 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Email Tools 验证 API 调用中有 100.0% 成功,响应时间中位数为 5.0 秒,共测量 1,968 次调用。
费用:每千次请求 US$6.60 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
验证邮箱地址的可送达性:返回状态结论(good、risky 或 bad),以及域名、邮箱、catch-all、一次性邮箱和角色邮箱信号和一个置信度分数。格式错误的地址会被输入 schema 拒绝,不扣费;每个语法有效的地址都会返回一个扣费的结论,包括无法送达的地址。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 Email Tools 验证 API 调用中有 100.0% 成功,响应时间中位数为 5.0 秒,共测量 1,968 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。