邮箱查找 API

通过名字、姓氏和公司域名，查找经过验证的工作邮箱。

查看 Markdown OpenAPI JSON

计费规则

邮箱查找工具收费仅在找到已验证邮箱时扣除 20 积分。未找到已验证结果、输入无效以及 Catch-all（全收）结果均不收费。批量和 CSV 请求要求当前积分足以覆盖任务可能返回的已验证邮箱数量。

工作原理

您提交 first_name， last_name，以及 domain。
VeriMails 会根据提供的姓名和域名，检查是否存在已验证的个人邮箱。
仅在完成实时验证后才返回结果。
如果无法确认已验证的邮箱，API 会返回not_found或 catch_all。
查找个人时，只要能够确认，VeriMails 就会返回已验证的个人邮箱地址。

查找单个邮箱

POST /api/find-email

适用于在您的应用或团队工具中逐个查找。

字段	必填	说明
`first_name`	是	此人的名字。
`last_name`	是	此人的姓氏。
`domain`	是	公司域名，例如`acme.com`。API 会自动规范化 URL。

cURL

curl -X POST https://verimails.com/api/find-email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jane","last_name":"Doe","domain":"company.com"}'

JSON

{
  "found": true,
  "email": "jane.doe@company.com",
  "status": "found",
  "confidence": 0.95,
  "elapsed_ms": 420
}

同步查找最多 100 个邮箱

小批量请使用同步批量接口。较大的文件请使用下方的 CSV 流程。

cURL

curl -X POST https://verimails.com/api/find-email/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leads": [
      {"first_name":"Jane","last_name":"Doe","domain":"company.com"},
      {"first_name":"Sam","last_name":"Lee","domain":"example.com"}
    ]
  }'

CSV 邮箱查找

需要大规模查找邮箱时，可上传 CSV。CSV 必须包含名字、姓氏和域名列。支持的别名包括 firstname， lastname， company_domain， website，以及 company_website。

CSV

first_name,last_name,domain
Jane,Doe,company.com
Sam,Lee,example.com

cURL

curl -X POST https://verimails.com/api/find-email/csv \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv"

curl https://verimails.com/api/find-email/csv/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://verimails.com/api/find-email/csv/JOB_ID/download \
  -H "Authorization: Bearer YOUR_API_KEY" -o finder_results.csv

输出的 CSV 会追加 found_email， finder_status， finder_confidence，以及 finder_elapsed_ms。

状态

状态	含义	计费
`found`	已找到经过验证的邮箱。	收费
`not_found`	未找到经过验证的个人邮箱。	不收费
`catch_all`	该域名接收任意地址的邮件，因此无法确认邮箱是否存在。	不收费
`invalid_input`	缺少必填的姓名或域名字段。	不收费
`insufficient_credits`	账户积分不足以覆盖本次请求的容量。	不收费