確実に動くメール検証 API

認証

すべてのリクエストで、API キーを Authorization ヘッダーの Bearer トークンとして送信してください。キーはサーバーに保管し、ブラウザのコードやモバイルアプリには絶対に含めないでください。

Authorization: Bearer YOUR_API_KEY

すべてのエンドポイントのベース URL は https://bouncebell.com/api/v1 です。

1 件のアドレスを検証

GET https://bouncebell.com/api/v1/verify

例

curl "https://bouncebell.com/api/v1/verify?email=rini.elizabeth%40acme-foods.example" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "email": "rini.elizabeth@acme-foods.example",
  "status": "valid",
  "reason": "mailbox_exists",
  "domain": "acme-foods.example",
  "mx_record": "mx1.acme-foods.example",
  "disposable": false,
  "role": false,
  "free_provider": false,
  "catch_all": false,
  "did_you_mean": null,
  "checked_at": "2026-10-30T09:30:12Z",
  "credits_used": 1
}

結果のフィールド

ステータス

バッチ

1 回のリクエストで最大 100,000 件のアドレスを送信できます。バッチはバックグラウンドで実行されます。ステータスをポーリングするか、callback_url を指定すると、バッチの完了時に呼び出します。

バッチを作成

POST https://bouncebell.com/api/v1/batches

curl -X POST "https://bouncebell.com/api/v1/batches" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "October import", "emails": ["a@example.com", "b@example.com"],
       "callback_url": "https://yourapp.example/hooks/bouncebell"}'

{ "id": "bat_8f2k1q3m9x7w4p", "status": "queued", "total": 2, "done": 0 }

バッチの作成時に、一意のアドレスごとのクレジットが確保され、完了時に不明の結果の分が返金されます。コールバックは {"event": "batch.completed", "batch_id": "...", "status": "done", "counts": {...}} を含む POST を受け取ります。コールバック URL には HTTPS が必要です。

進捗を確認

GET https://bouncebell.com/api/v1/batches/{id}

{ "id": "bat_8f2k1q3m9x7w4p", "status": "running", "total": 2, "done": 1 }

ステータスは queued、running、done のいずれかです。done の場合、レスポンスにはステータス別の counts も含まれます。

結果をダウンロード

GET https://bouncebell.com/api/v1/batches/{id}/results

デフォルトでは JSON を返します。CSV ファイルが必要な場合は ?format=csv を追加してください。各行には個別チェックと同じフィールドが含まれます。

クレジット

GET https://bouncebell.com/api/v1/credits

{ "credits_remaining": 33420 }

エラーと制限

エラー時は、error コードと読みやすい message を含む JSON 本文が返ります。

個別チェックは、キーごとに毎秒 20 リクエストまでです。さらに必要な場合はご相談ください。