メールアドレス検証API:キャッチオールドメインのアドレスも判定
1回のREST呼び出しで、メールボックスが存在するかを確認できます。キャッチオールドメインでは、多くのAPIは「accept-all」や「リスクあり」で止まります。このAPIは、同じレスポンスの中で有効か無効かの答えを返します。開発チームは、整ったJSONデータを使って、営業メールの送信フロー全体で送信者レピュテーションを守れます。
curl -X POST https://api.giggal.ai/v1/verify \
-H "Authorization: Bearer tp_live_xxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"email":"alex.smith@example.com"}'無料クレジット1,000件付き。クレジットカードは不要です。クレジットに有効期限はありません。
Giggal.aiはSourceForgeとSlashdotでLeaderと評価されています
1回のAPI呼び出しで返るデータ
1回の呼び出しで、到達率に関するデータをまとめて返します。到達可否のステータス、リスクの評価、数値の到達スコア、メールボックスの属性、キャッチオールドメインの判定結果が含まれます。
{
"success": true,
"data": {
"email": "alex.smith@example.com",
"is_valid": true,
"status": "deliverable",
"risk_level": "low",
"deliverability_score": 92,
"catch_all_score": 89,
"catch_all_verdict": "valid",
"details": {
"general": {
"domain": "example.com",
"reason": "Mailbox confirmed deliverable"
},
"attributes": {
"free_email": false,
"role_account": false,
"disposable": false,
"catch_all": true,
"has_plus_tag": false,
"mailbox_full": false,
"no_reply": false
},
"mail_server": {
"smtp_provider": "google",
"mx_record": "aspmx.l.google.com"
}
}
},
"meta": {
"creditsUsed": 1
}
}ステータスの値の扱い方
主な配信ステータスはstatusフィールドで返されます。バックエンドのアプリケーションでは、それぞれの値を次のように扱ってください。
| ステータス | 意味 | 推奨する対応 |
|---|---|---|
| deliverable | 送信先のメールサーバーが受信者を受け付けました。メールボックスは使われています。 | 送信できます。主なキャンペーンに含めてください。 |
| undeliverable | メールボックスが存在しない、形式が正しくない、ドメインにMXレコードがない、またはドメインが使い捨てです。 | 送信しないでください。ハードバウンスを避けるため、キャンペーンから削除してください。 |
| unknown | サーバーの応答から結論が出ませんでした。グレーリスティングや接続のタイムアウトが主な原因です。 | 後でもう一度チェックしてください。不明の結果に使ったクレジットは自動で返却されます。 |
キャッチオールドメインのアドレスを同じ呼び出しで判定
通常のチェックは、キャッチオールドメインでは答えを出せません。企業のメールサーバーがすべてのアドレスを受け付ける場合、通常のツールには、実在するメールボックスにも入力ミスのアドレスにも同じ肯定の応答が返ります。それ以上確認できないため、多くのツールはアドレスを「リスクあり」や「accept-all」とし、判断を利用者に任せます。
一般的なB2Bのリストでは、約30%のアドレスが、キャッチオールドメインか、ProofpointやMimecastのようなセキュアメールゲートウェイ(SEG)の背後にあるドメインにあります。これらを削除すると、実在する購入者を失います。検証せずに送信すると、バウンスが急に増えます。
Giggalの検証エンジンは、同じ呼び出しの中でキャッチオールドメインのアドレスを詳しく判定します。メールボックスが存在するかをチェックし、catch_all_verdict("valid"または"invalid")と、0〜100のcatch_all_scoreを返します。詳しくは、キャッチオールドメインの検証と、セキュアメールゲートウェイの背後にあるメールボックスのチェックについてのガイドをご覧ください。
従来の検証API
accept-allのドメインでは判定しない
{
"email": "sarah.connor@cyberdyne.com",
"status": "risky",
"reason": "accept_all_domain",
"is_deliverable": null,
"action": "manual_review_required"
}判断はチームに任されます。送信してバウンスの増加を受け入れるか、有効な見込み客を削除するかです。
Giggal.ai API
キャッチオールドメインを同じ呼び出しで判定
{
"email": "sarah.connor@cyberdyne.com",
"status": "deliverable",
"is_valid": true,
"catch_all_verdict": "valid",
"catch_all_score": 94,
"details": { "catch_all": true }
}メールボックスが存在することを確認済みです。キャッチオールドメインの実在する連絡先を残し、送信者レピュテーションを守れます。
1件、一括、キャッチオールドメインのチェック用のエンドポイント
連絡先1件のチェックにも、大きなリストの検証にも、それぞれ専用のエンドポイントがあります。
メールアドレス1件の検証
メールアドレス1件を同期で検証します。アドレスが存在するかを確認し、ドメインを診断し、キャッチオールドメインのアドレスも同じ呼び出しで判定します。結果はすべてJSONで返します。
エンドポイントのドキュメントを見るメールアドレスの一括検証
1ジョブあたり最大50,000件のアドレスを非同期で処理します。重複と形式の誤りはサーバー側で取り除きます。二重課金を防ぐIdempotency-Keyヘッダーに対応しています。
ジョブの状態確認と結果の取得
GET /v1/jobs/:jobIdで、10〜15秒ごとにジョブの進み具合を確認します。結果は1ページ最大500件で、ページ分割して取得します。結果は48時間保存されます。
キャッチオールドメインの一括判定
完了した一括ジョブでキャッチオールドメインと判定されたアドレスを、まとめて詳しく判定します。結果は、スコアとステータスの列が入ったCSVでダウンロードできます。
キャッチオールドメインのドキュメントを見るすべてのレスポンスに含まれるフラグ
すべてのレスポンスには、有効か無効かのほかに、メールボックスの詳しい属性が含まれます。見込み客の分類、不正利用の防止、自動のフィルタールールに使えます。
| フラグ | フィールドのパス | 説明と使い方 |
|---|---|---|
| 使い捨て | details.attributes.disposable | 一時的な使い捨ての受信トレイを見分けます。無料トライアルの不正利用を防ぐため、すぐにブロックしてください。 |
| 役割アドレス | details.attributes.role_account | 部署共通のメールボックス(info@、billing@、support@)を見分けます。CRMの担当チームに回してください。 |
| フリーメール | details.attributes.free_email | 個人向けのウェブメールのドメイン(gmail.com、yahoo.com)に印を付けます。個人の受信トレイと企業の見込み客を分けられます。 |
| キャッチオールドメイン | details.attributes.catch_all | ホストがすべてのメールを受け付けるかを示します。catch_all_verdictと組み合わせて、有効な見込み客を残せます。 |
| プラスタグ | details.attributes.has_plus_tag | サブアドレス(user+tag@)を使ったアドレスを見分けます。1人が複数のアカウントを作るのを防げます。 |
| メールボックスの容量超過 | details.attributes.mailbox_full | 保存容量の上限を超えていることを示します。このアドレスに送るとソフトバウンスになります。 |
| 返信不可(No-Reply) | details.attributes.no_reply | 誰も読んでいない一斉送信用のアドレスに印を付けます。やり取りを目的とした営業メールは送らないでください。 |
| ブラックリストのチェック | details.blacklist.is_blacklisted | ドメインとサーバーのIPを主要なDNSBLで確認し、レピュテーションのスコアを付けます。 |
メールアドレス検証APIの使いみち
エンドポイントは、データパイプライン、CRMのワークフロー、データベースに直接つなげられます。
CRMとデータウェアハウスの同期
Salesforce、HubSpot、Snowflakeに同期する前に、連絡先データを継続して検証します。古いレコードを定期的にクリーニングし、連絡先データを正確に保てます。
キャンペーン用のリストのクリーニング
大きな配信の前にメールリストをクリーニングします。手作業ですばやく行うなら、メールリストのクリーニングの画面から直接リストをアップロードすることもできます。
リードのエンリッチメント
インバウンドのSDRやアウトバウンドのエンリッチメントツールが新しい企業のメールアドレスを見つけるたびに、メールボックスのチェックを自動で実行します。営業担当者は検証済みのアドレスにだけ連絡できます。
ワークフローの自動化
連携のページから、検証のエンドポイントをZapier、n8n、Make、Webhookのワークフローに直接つなげられます。
MCPを使うAIエージェント
MCPサーバーを使うと、Claude、ChatGPT、Cursor、独自のAIエージェントが、会話の中で連絡先を検証できます。
登録フォームでのチェック
登録フォームやリード獲得フォームで、入力されたアドレスをその場でチェックしたい場合は、フォームのリアルタイムチェック用のメールアドレスのバリデーションAPIをご覧ください。
コード例
1件と一括のチェックのための、サーバー側のコード例です。APIキーは環境変数に保存してください。
// Node.js (Node 18+)
const res = await fetch('https://api.giggal.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email: 'alex.smith@example.com' }),
});
const data = await res.json();
if (data.success) {
console.log('Status:', data.data.status); // deliverable, undeliverable, unknown
console.log('Catch-all result:', data.data.catch_all_verdict); // valid | invalid
} else {
console.error('Verification error:', data.error);
}import os
import requests
url = "https://api.giggal.ai/v1/verify"
headers = {
"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}",
"Content-Type": "application/json"
}
payload = {"email": "alex.smith@example.com"}
response = requests.post(url, json=payload, headers=headers)
result = response.json()
if result.get("success"):
data = result["data"]
print("Status:", data["status"])
print("Catch-All Result:", data.get("catch_all_verdict"))
else:
print("Error:", result.get("error"))一括の流れ:送信、状態確認、結果の取得
バッチジョブの送信は1回の呼び出しで済みます。ジョブのステータスがcompletedになるまで、10〜15秒ごとに状態を確認してください。
// 1. Submit batch job (up to 50,000 emails)
const submitRes = await fetch('https://api.giggal.ai/v1/verify-batch', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'batch-job-2026-10-01-01',
},
body: JSON.stringify({
name: 'Q4 Sales Leads',
emails: ['alex.smith@example.com', 'maria.garcia@example.org'],
}),
});
const { data: job } = await submitRes.json();
const jobId = job.jobId;
// 2. Poll job status until completed
// GET https://api.giggal.ai/v1/jobs/${jobId}
// 3. Fetch paginated verification results
const resultsRes = await fetch(`https://api.giggal.ai/v1/jobs/${jobId}/results?page=1&limit=500`, {
headers: { 'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}` },
});
const results = await resultsRes.json();メールアドレス検証APIの料金
月額の契約がない、わかりやすい従量課金です。1クレジットでアドレス1件を検証します。1件ずつのAPIチェックでは、キャッチオールドメインの判定も同じ1クレジットに含まれます。一括のバッチジョブでは、通常の検証がアドレス1件につき1クレジットで、キャッチオールドメインの行を詳しく判定すると、チェックしたキャッチオールドメインのアドレス1件につき1クレジットかかります。クレジットに有効期限はなく、不明の結果は自動で返却されます。
さらに大量の検証が必要な場合は、すべての料金プランをご覧ください。
レート制限とエラー
APIキーごとに標準のレート制限があります。レート制限の状況は、すべてのリクエストで標準のヘッダーX-RateLimit-LimitとX-RateLimit-Remainingで返されます。
15分間あたりのレート制限
- 1件のチェック(/v1/verify)15分あたり300リクエスト
- バッチジョブの作成15分あたり30リクエスト
- キャッチオールドメインのジョブの作成15分あたり30リクエスト
- ジョブの状態確認と結果の取得15分あたり600リクエスト
HTTPステータスのエラーコード
- 400 Bad Request: 形式が正しくない、またはJSONの本文が壊れています。
- 401 Unauthorized: APIキーがない、期限切れ、または無効です。
- 402 Payment Required: アカウントのクレジット残高が足りません。
- 404 Not Found: 指定したジョブIDが存在しません。
- 409 Conflict: Idempotency-Keyのペイロードが競合しています。
- 410 Gone: バッチジョブの結果は48時間で期限切れになりました。
- 429 Too Many Requests: レート制限の上限を超えました。
エラーレスポンスの詳しい形式と内容は、APIのエラーに関するドキュメントにあります。
利用者の声
Giggal.aiを使っている開発、営業、グロースのチームからの実際の声です。
"Before Giggal, our team spent hours manually reviewing catch-all addresses because other tools couldn't verify them with confidence. Now we upload large email lists, verify them in minutes, and move directly into campaign preparation."
Vernon L.
G2の認証済みレビュアー
"Fast and accurate email verification, excellent catch-all detection, easy-to-use interface, quick processing for large lists, lower bounce rates, improved sender reputation, and more confidence before launching email campaigns."
Billy W.
SourceForgeのレビュアー
"Giggal Email Verifier makes email validation fast, simple, and reliable. It helps us clean our lists, reduce bounce rates, and improve the overall performance of our outreach campaigns. The accuracy of the verification results makes it a valuable tool."
Hazel Peterson
Product Huntのレビュアー
メールアドレス検証APIに関するよくある質問
認証、メールボックスのチェック、キャッチオールドメインの扱いについての、技術的なよくある質問です。
はい。新しいアカウントには、登録するとすぐに無料クレジット1,000件が付きます。クレジットカードは不要です。開発者用のダッシュボードでAPIキーを作成すれば、すぐに検証のリクエストを送れます。無料クレジットに有効期限はなく、メールボックスのチェックやキャッチオールドメインの詳しい判定を含め、すべてのエンドポイントを使えます。
APIはメールボックスが存在するかを確認します。DNSとMXを調べ、送信先のメールサーバーに接続し、そのメールボックスが存在してメールを受け取れるかをチェックします。メッセージを送る前に接続を正しく閉じるため、受信者にメールは届きません。
キャッチオールドメインでは、メールサーバーがすべてのアドレスを受け付けると答えます。そのため、通常のツールは「リスクあり」や「不明」を返します。Giggalはメールボックスが存在するかをチェックし、有効か無効かの結果と、0〜100のcatch_all_scoreを返します。実在する見込み客を削除せずに済みます。
「不明」のステータスは、送信先のメールサーバーが制限時間内にはっきりした答えを返さなかったときに出ます。主な原因は、厳しいグレーリスティングやサーバーの一時的な停止です。結論が出なかった答えに料金はかかりません。不明のステータスが返った検証に使ったクレジットは、自動でアカウントの残高に返却されます。
1件の検証リクエストは、1回の呼び出しでメールアドレス1件を同期でチェックし、JSONで直接返します。リストの検証には一括APIのエンドポイントを使います。1つのバッチジョブで最大50,000件のメールアドレスを非同期で受け付けます。ジョブの状態確認で進み具合を追い、処理が終わったら結果をページ分割して取得できます。
はい。Giggal.aiは公式のリモートMCP(Model Context Protocol)サーバーをhttps://mcp.giggal.ai/mcpで提供しています。ClaudeとChatGPTは、OAuthでこのサーバーに接続するため、APIキーは不要です。Cursor、VS Codeなどのクライアントでローカルに使う場合は、APIキーを設定したローカルのgiggal-mcpサーバーで、エディターから直接アドレスを検証できます。
メールアドレス検証APIは、送信先のメールサーバーと直接やり取りし、DNSレコードを確認して、メールボックスが実際に存在するかを調べます。営業リストや顧客データベースにあるキャッチオールドメインのアドレスも判定します。メールアドレスのバリデーションAPIは、主に登録フォームでのリアルタイムのチェックに使います。形式を確認し、使い捨てのドメインを見分け、送信の時点で偽のアカウントを防ぎます。フォームを守りたい場合は、メールアドレスのバリデーションAPIをご覧ください。
確認するべき点は3つです。1つ目は、キャッチオールドメインを本当に判定できることです。判定できないと、B2Bの連絡先の最大30%が「リスクあり」に分類されて使えなくなります。2つ目は、不明の結果のクレジットを自動で返却する、わかりやすい課金ルールです。3つ目は、検証1件あたりの料金が明確で、隠れた定期料金や月額の最低料金がないことです。
