ドキュメント/一括検証

一括検証

メールアドレスのCSVをアップロードして、リスト全体の結果を取得します。

Markdownを表示 OpenAPI JSON

概要

一括検証では、1つのジョブで数千件のメールアドレスを検証できます。ダッシュボードまたはAPIからCSVファイルをアップロードし、ジョブの完了後に結果をダウンロードします。

ℹ️
一括検証はダッシュボードとAPIから利用できます。CSVファイルをPOST /api/bulkでアップロードし、GET /api/bulk/{job_id}で状態を確認し、完了後に次のエンドポイントから結果をダウンロードします: /api/bulk/{job_id}/download。

APIでのアップロード

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。ヘッダーのない1列のCSVにも対応していますが、明確なメールのヘッダーを付けることをおすすめします:

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

その他の列は出力にそのまま残り、処理には影響しません。

対応形式

出力形式

完全な結果ファイルは元のCSVの列を保持し、送信可否を示す列を末尾に追加します:

追加される列説明
Safe to SendYes (検証ステータスが有効の場合)、 No (無効、キャッチオール、使い捨て、不明、リスクありの場合)。

ジョブのステータスの確認

ダッシュボードのジョブ一覧では、進捗をリアルタイムで確認できます。APIの場合は、GET /api/bulk/{job_id}をポーリングし、ジョブのステータスが次になるまで待ちます: completed または failed。

Webhook通知

一括ジョブ完了時のWebhook対応は近日公開予定です。詳細: Webhook →

💡
ヒント: リアルタイムでリストを作成する場合は、単一検証API を使って、収集と同時にアドレスを検証しましょう。一括検証は既存リストのクリーニングに最適です。