文件/大量驗證

大量驗證

上傳電子郵件地址 CSV,取得整份名單的結果。

檢視 Markdown OpenAPI JSON

總覽

大量驗證讓您在單一作業中驗證數千個電子郵件地址。透過控制台或 API 上傳 CSV 檔案,作業完成後下載結果。

ℹ️
大量驗證可透過控制台與 API 使用。上傳 CSV 檔案請使用POST /api/bulk,輪詢GET /api/bulk/{job_id},接著從以下端點下載結果: /api/bulk/{job_id}/download。

透過 API 上傳

以 multipart 格式連同 API 金鑰上傳 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"

透過控制台上傳

  1. 登入 verimails.com/dashboard
  2. 點選大量驗證(位於側邊欄)
  3. 上傳 CSV 檔案
  4. 等待作業完成(會顯示在作業清單中)
  5. 下載結果 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 欄位,並附加一個清楚的可寄送欄位:

新增欄位說明
Safe to SendYes (驗證狀態為有效時);No(無效、Catch-all、拋棄式、未知或有風險的結果)。

查詢作業狀態

在控制台中,作業清單會顯示即時進度。透過 API 時,請輪詢GET /api/bulk/{job_id},直到作業狀態變為completed或 failed。

Webhook 通知

大量作業完成的 Webhook 支援即將推出。請參閱 Webhook →

💡
提示:即時建立名單時,請使用單筆驗證 API 在收集地址的同時進行驗證。大量驗證最適合用來清理現有名單。