批量验证

上传包含邮箱地址的 CSV，获取整个列表的验证结果。

查看 Markdown OpenAPI JSON

概览

批量验证可在一个任务中验证数千个邮箱地址。通过控制台或 API 上传 CSV 文件，任务完成后下载结果。

ℹ️

批量验证可通过控制台和 API 使用。使用POST /api/bulk上传 CSV 文件，轮询GET /api/bulk/{job_id}，然后下载结果： /api/bulk/{job_id}/download。

通过 API 上传

使用 API 密钥发送 multipart CSV 上传请求。可选传入email_column，适用于邮箱字段未命名为 email。

bash

curl -X POST https://verimails.com/api/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv" \
  -F "name=May outreach" \
  -F "email_column=Email Address"

通过控制台上传

登录 verimails.com/dashboard
点击批量验证（位于侧边栏）
上传 CSV 文件
等待任务完成（显示在任务列表中）
下载结果 CSV

CSV 格式

CSV 必须包含一列邮箱地址。VeriMails 会自动识别常见表头，例如 email， Email Address， work_email，以及business_email。也支持无表头的单列 CSV，但最好还是使用清晰的邮箱表头：

csv

email
john@example.com
jane@company.com
info@business.io
sales@corp.net

其他列会保留在输出中，不影响处理。

支持的格式

使用逗号或分号分隔的 CSV 文件
UTF-8 编码
每个任务最多 500,000 行
文件大小上限：50MB

输出格式

完整结果文件会保留原始 CSV 列，并追加一列清晰的可发送状态：

新增列	说明
`Safe to Send`	`Yes` ：验证状态为有效；`No`：结果为无效、Catch-all、一次性邮箱、未知或有风险。

查看任务状态

在控制台中，任务列表会显示实时进度。通过 API 时，轮询GET /api/bulk/{job_id}，直到任务状态变为completed或 failed。

Webhook 通知

批量任务完成的 Webhook 支持即将推出。详见 Webhook →

💡

提示：实时构建列表时，请在收集地址的同时使用单个验证 API 进行验证。批量验证最适合清洗现有列表。