一括検証
メールアドレスのCSVをアップロードして、リスト全体の結果を取得します。
概要
一括検証では、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"
ダッシュボードでの アップロード
- 次にログインします: verimails.com/dashboard
- サイドバーの一括検証をクリックします
- CSVファイルをアップロードします
- ジョブが完了するまで待ちます(ジョブ一覧に表示されます)
- 結果の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ファイル
- UTF-8エンコーディング
- 1ジョブあたり最大500,000行
- 最大ファイルサイズ:50MB
出力形式
完全な結果ファイルは元のCSVの列を保持し、送信可否を示す列を末尾に追加します:
| 追加される列 | 説明 |
|---|---|
Safe to Send | Yes (検証ステータスが有効の場合)、 No (無効、キャッチオール、使い捨て、不明、リスクありの場合)。 |
ジョブの ステータスの 確認
ダッシュボードのジョブ一覧では、進捗をリアルタイムで確認できます。APIの場合は、GET /api/bulk/{job_id}をポーリングし、ジョブのステータスが次になるまで待ちます: completed または failed。
Webhook通知
一括ジョブ完了時のWebhook対応は近日公開予定です。詳細: Webhook →
ヒント: リアルタイムでリストを作成する場合は、単一検証API を使って、収集と同時にアドレスを検証しましょう。一括検証は既存リストのクリーニングに最適です。