Email Finder 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`	您的帳號點數不足以支應此請求的容量。	不扣點