メールファインダーAPI

名、姓、会社ドメインから、検証済みのビジネス用メールアドレスを見つけます。

課金ルール

メールファインダーの料金は検証済みのメールが見つかった場合のみ20クレジットです。検証済みのヒットがない場合、入力が無効な場合、キャッチオールの結果には課金されません。一括リクエストやCSVリクエストでは、ジョブが返しうる検証済みメールの数に見合う現在のクレジットが必要です。

仕組み

リクエストで送信する項目： first_name、 last_name、 domain。
VeriMailsは、指定された名前とドメインについて、検証済みの個人メールボックスがあるかを確認します。
結果は、リアルタイムの検証を経てから返されます。
検証済みのメールボックスを確認できない場合、APIは次を返します：not_foundまたは catch_all。
人物の検索では、確認できた場合に限り、VeriMailsは検証済みの個人メールアドレスを返します。

1件のメールを検索

POST /api/find-email

アプリケーションやチームのツールから1件ずつ検索する場合に使用します。

フィールド	必須	説明
`first_name`	はい	人物の名。
`last_name`	はい	人物の姓。
`domain`	はい	会社のドメイン（例：`acme.com`）。URLはAPIで正規化されます。

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`	リクエストの処理に必要なクレジットがアカウントに不足しています。	課金なし