スパムチェックAPI：
メール、受信トレイ、ドメイン

クイックスタート

3回の呼び出し。キー、アカウント、登録は不要です。 2回のリクエストと1通のメール。3回目の呼び出しが必要なのは、分析に数秒かかるためです。

1. アドレスを予約

   inboxエンドポイントにPOSTします。正確に1通のメッセージだけを受信し、1時間で期限切れになるアドレスと、その他すべてのキーとなるスラッグが返されます。

   リクエスト

   # 1. reserve a single-use address
   curl -sX POST 'https://email-spam-tester.com/api/v1/inbox?lang=en'

   レスポンス

   {
     "address": "test-<slug>@t.email-spam-tester.com",
     "slug": "<slug>",
     "expires_at": "2026-01-01T12:00:00Z"
   }

2. 実際のメッセージをそこに送信

   キャンペーンを送信するプラットフォームから、SMTP経由で送信します。チェックの半数は送信プラットフォームが追加するヘッダーを確認するため、手作業で作成したメッセージでは誤った対象を測定することになります。

   リクエスト

   # 2. send your message to that address, from your own platform
   To: test-<slug>@t.email-spam-tester.com

3. ステータスをポーリングしてからレポートを取得

   statusエンドポイントのレスポンスは数百バイトで、完全なレポートを取得する段階かどうかを確認できます。レポート自体は数千行に及びます。

   リクエスト

   # 3. poll
   curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>/status'

   レスポンス

   {
     "slug": "<slug>",
     "analysis_status": "checks_ready",
     "ai_status": "running",
     "checks_done": 42,
     "checks_total": 42
   }

   リクエスト

   # 4. read the report once analysis_status is checks_ready
   curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>'

   レスポンス

   {
     "report_url": "https://email-spam-tester.com/t/<slug>",
     "score_ours": 86.4,
     "score_compat": 9.2,
     "subscores": {"auth": 100.0, "infra_spam": 78.1, "content": 92.0, "compliance": 75.0},
     "complete": true,
     "checks": [
       {
         "id": "auth.dmarc",
         "status": "warn",
         "title": "DMARC result",
         "summary": "DMARC passes, but the policy is p=none.",
         "weight_ours": -4.0,
         "evidence": {"policy": "none", "aligned": "dkim"},
         "citations": {"standards": [{"title": "RFC 9989 §4.7", "quote": "..."}]}
       }
     ],
     "fixes": [
       {"id": "dmarc-enforce", "gain_ours": 4.0, "gain_compat": 0.0,
        "fix": {"title": "Move DMARC to quarantine", "severity": "medium"}}
     ]
   }

アドレスを予約し、配信リストに送ろうとしていたメッセージを送信して、レポートを確認します。ページに表示されるすべての情報がJSONに含まれています。スコア、根拠を含む42項目すべてのチェック、および各検出結果の根拠となる標準のセクションも含まれます。

最初の100,000件のレポートは、キーもアカウントも不要で無料です。スクリプトではなくエージェントを接続する場合は、ポーリングよりもMCPサーバーの方が適しています。

エンドポイント

ベースアドレスは https://email-spam-tester.com です。すべてJSONで応答します。

クイックスタート

1. テストを作成

   placementエンドポイントにPOSTします。マーカーとテスト用受信トレイが返されます。

   リクエスト

   # 1. create a test
   curl -sX POST 'https://email-spam-tester.com/api/v1/placement' \
     -H 'Content-Type: application/json' \
     -d '{"public_results_accepted":true}'

   レスポンス

   {
     "slug": "<slug>",
     "marker": "est-3f9a1c7e2b4d6a80c5e1f2d3",
     "status": "waiting",
     "deadline": "2026-10-31T12:30:00Z",
     "poll_after_seconds": 60,
     "results": [
       {"address": "<seed>", "provider": "gmail", "kind": "Gmail",
        "placement": "pending", "observed_at": null}
     ],
     "fleet": {
       "status": "observing",
       "results": [
         {"address": "<mailbox>", "provider": "yahoo", "available": true,
          "placement": "pending", "coverage": "pending"}
       ]
     }
   }

2. すべての受信トレイに1通ずつ送信

   件名にマーカーを入れ、通常使用しているプラットフォームからすべてのアドレスに一括で送信します。

   リクエスト

   # 2. one message to every address, with the marker in the subject
   Subject: October invoice est-3f9a1c7e2b4d6a80c5e1f2d3
   To: <seed>, <mailbox>, ...

3. フォルダーをポーリング

   各アドレスにプロバイダーとフォルダーが入力されます。statusがwaitingでなくなるまでポーリングします。

   リクエスト

   # 3. poll for the folders
   curl -s 'https://email-spam-tester.com/api/v1/placement/<slug>'

   レスポンス

   {
     "status": "complete",
     "received": 2,
     "total": 2,
     "results": [
       {"address": "<seed>", "provider": "gmail", "kind": "Gmail",
        "placement": "primary", "observed_at": "2026-10-31T12:04:11Z"},
       {"address": "<seed>", "provider": "gmail", "kind": "Google Workspace",
        "placement": "promotions", "observed_at": "2026-10-31T12:04:11Z"}
     ],
     "fleet": {
       "status": "finished",
       "results": [
         {"address": "<mailbox>", "provider": "yahoo", "available": true,
          "placement": "inbox", "coverage": "ok"},
         {"address": "<mailbox>", "provider": "outlook", "available": true,
          "placement": "spam", "coverage": "ok"}
       ]
     }
   }

エンドポイント

クイックスタート

1. GETを1回実行します

   ドメインを渡します。ipには送信元アドレスを追加し、selectorには読み取るDKIMセレクターを指定します。

   リクエスト

   curl -s 'https://email-spam-tester.com/api/v1/infra/check?domain=example.com&selector=mail&diff=true'

2. 判定を確認します

   スクリプト用の結果はokで、sectionsはどの部分が失敗したかを示します。

   レスポンス

   {
     "id": "ir_01JB8Y4T2M6K9QZ7H3V5N1XWDA",
     "domain": "example.com",
     "checked_at": "2026-10-31T12:00:00Z",
     "ok": false,
     "status": "fail",
     "score": 78,
     "coverage": {"answered": 7, "total": 8},
     "ips": [{"ip": "203.0.113.5", "sources": ["mx", "spf"], "managed": false}],
     "sections": {
       "dkim": {"status": "pass", "core": true, "findings": [], "data": {}},
       "ptr": {"status": "fail", "core": true, "findings": [], "data": {}}
     },
     "not_checked": [
       {"check": "dkim_signature", "reason": "needs_a_message"},
       {"check": "alignment", "reason": "needs_a_message"}
     ],
     "diff": {
       "baseline": {"id": "ir_01JB2...", "checked_at": "2026-10-24T12:00:00Z"},
       "first_run": false,
       "changed": true,
       "worsened": true,
       "status_from": "pass",
       "score_from": 100,
       "changes": [
         {"path": "dkim.key.mail.sha256", "section": "dkim", "kind": "removed",
          "severity": "critical", "effect": "worsened", "from": "9f2c...", "to": null}
       ],
       "not_compared": [
         {"path": "blocklist_ip.203.0.113.5.bl.spamcop.net.listed", "reason": "lookup_failed"}
       ]
     }
   }

3. cronに追加します

   diff=trueを指定すると、各実行結果が前回の結果と比較され、jqがその結果を終了コードに変換します。

   リクエスト

   # exits non-zero if the domain is broken or its setup changed
   curl -s 'https://email-spam-tester.com/api/v1/infra/check?domain=example.com&selector=mail&diff=true' \
     | jq -e '.ok and (.diff.changed | not)'

応答の読み方

完了したチェックは 200 を返し、判定結果は本文に含まれます。status は必須セクションである spf、dkim、dmarc、ptr、blocklist_ip、blocklist_domain、mx、smtp のうち最も悪いものです。必須セクションの unknown は warn として扱われます。status が pass または warn の場合、ok は true です。score は、応答が得られた必須セクションを対象に 0 から 100 までの値になり、error と unknown によって該当する重みの半分未満しか残らない場合は null です。mta_sts、tls_rpt、bimi、dnssec、dane、ns、registration は報告および比較されますが、ok や score には影響しません。

セクションの状態は pass、warn、fail、error (チェックできませんでした)、unknown (判断材料が不足しています)、skipped (該当しません) のいずれかです。skipped は結果に影響せず、理由は not_checked に含まれます。dkim_signature と alignment は実際のメッセージを必要とするため、常に存在します。

ip と selector による違い

PTR とブロックリストはアドレスに関するため、実行にはアドレスが必要です。渡された ip 値を使用します。指定がない場合は、MX ホスト、およびルート SPF レコード内の単一アドレスの ip4: と ip6: の項目から最大 4 件を取得します。既知のメールプロバイダーのアドレスは managed として一覧に記載され、チェックされません。対象が何も残らない場合、ptr と blocklist_ip は skipped を返します。selector は DNS から読み取れないため、実行時には指定されたもの、以前の実行で見つかったもの、一般的な名前のリストを試します。何も見つからなくても何も証明されないため、dkim は unknown を返します。独自のサーバーから送信する場合は、両方を渡してください。

変更内容

diff.changes の各エントリには、path、kind (added、removed、changed)、severity (critical、warning、info)、effect (worsened、improved、neutral) があります。diff.changed が設定されるのは critical と warning の場合だけなので、同じ長さの DKIM キーへのローテーション、新しい MX アドレス、更新された証明書では cron は反応しません。diff.worsened は、いずれかの変更の effect に従います。初回の実行では比較対象がなく、diff.first_run がそのことを示します。

ベースラインは常に自分の実行のいずれかであるため、自分の 2 回の実行の間に別の人がそのドメインをチェックしても、何も見落とされません。今回読み取れなかったものはすべて、最後に確認できた値を保持したまま diff.not_compared に入ります。つまり、障害中に行われた変更は、検索が再び機能すると表示されます。異なる ip または selector を使用した実行も同じ系列に残り、その実行で確認を要求しなかったものも比較されません。

定期チェックでキーを使う理由

キーがない場合、履歴は IP アドレスのキー付きハッシュに紐づくため、アドレスが変わると途切れます。また、同じアドレスを使用する人同士で履歴が共有されるため、同僚の実行によってベースラインが移動します。Authorization: Bearer に個人用 API キーを指定すると、履歴はそのキーに紐づきます。キーを使用した実行は 365 日間保持され、そのキーでのみ開けます。キーを使用しない実行は 30 日間保持され、id を知っている人なら誰でも開けます。

上限は IP ごとに 1 分あたり 6 リクエスト、1 日あたり 50 リクエスト、またはキーごとに 1 分あたり 30 リクエスト、1 日あたり 500 リクエストです。これを超えると、Retry-After を伴う 429 が返されます。60 秒以内の同一リクエストはキャッシュから返され、cached: true とマークされます。実行は書き込まれず、リクエスト数にもカウントされません。保存済みの実行の読み取りは、クライアントごとに 1 分あたり 120 リクエストまで可能です。Retry-After を伴う 503 は、実行中のチェックが多すぎることを示します。また、保存済みの実行を読み取る場合は、ストレージを利用できないことを示します。401 はキーが正しくないことを示します。422 には detail.code として invalid_domain、invalid_ip、invalid_selector、invalid_check、invalid_since、unknown_baseline、account_required のいずれかが含まれます。

エンドポイント

クイックスタート

1. チェックを選択

   以下のリストからツールを選択し、そのツールが要求するドメイン、アドレス、または IP を渡します。

   リクエスト

   curl -s 'https://email-spam-tester.com/api/v1/tools/spf?domain=example.com'

2. ステータスと検出事項を確認

   すべてのツールは、ステータスと検出事項を返します。それ以降のフィールドはツールによって異なります。

   レスポンス

   {
     "tool": "spf",
     "query": {"domain": "example.com"},
     "checked_at": "2026-10-31T12:00:00Z",
     "duration_ms": 412,
     "status": "fail",
     "findings": [
       {"code": "spf.too_many_lookups", "level": "fail",
        "params": {"limit": 10, "count": 12},
        "message": "RFC 7208 §4.6.4 allows at most 10 DNS lookups, and this record needs 12, so receivers return permerror."}
     ],
     "record": "v=spf1 include:_spf.example.net ~all",
     "lookups": {"count": 12, "limit": 10, "void": 0}
   }

エンドポイント