ईमेल, इनबॉक्स और डोमेन के लिए
स्पैम जाँच API

त्वरित शुरुआत

तीन कॉल। कोई कुंजी नहीं, कोई खाता नहीं, कोई साइनअप नहीं। दो अनुरोध और एक ईमेल। तीसरी कॉल केवल इसलिए है क्योंकि विश्लेषण में कुछ सेकंड लगते हैं।

1. एक पता आरक्षित करें

   इनबॉक्स एंडपॉइंट पर POST करें। आपको ऐसा पता मिलता है जो ठीक एक संदेश स्वीकार करता है और एक घंटे में समाप्त हो जाता है, साथ ही वह स्लग भी मिलता है जिस पर बाकी सब कुछ आधारित है।

   अनुरोध

   # 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. स्थिति की पोलिंग करें, फिर रिपोर्ट पढ़ें

   स्थिति एंडपॉइंट कुछ सौ बाइट का है और आपको बताता है कि पूरी रिपोर्ट अभी फ़ेच करने योग्य है या नहीं। रिपोर्ट स्वयं कई हज़ार पंक्तियों की होती है।

   अनुरोध

   # 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. परीक्षण बनाएँ

   प्लेसमेंट एंडपॉइंट पर 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. हर इनबॉक्स पर एक संदेश भेजें

   विषय में मार्कर डालें और अपने सामान्य प्लेटफ़ॉर्म से सभी पतों पर एक ही बार में भेजें।

   अनुरोध

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

3. फ़ोल्डर के लिए पोल करें

   हर पते में उसका प्रदाता और फ़ोल्डर भर जाता है। तब तक पोल करें जब तक स्थिति 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 करें

   डोमेन दें। ip आपके भेजने वाले पते जोड़ता है, और selector पढ़े जाने वाले DKIM selectors के नाम देता है।

   अनुरोध

   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 उत्तर को exit code में बदलता है।

   अनुरोध

   # 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 लौटाती है, और verdict body में होता है। status आवश्यक sections में सबसे खराब है: spf, dkim, dmarc, ptr, blocklist_ip, blocklist_domain, mx और smtp। किसी आवश्यक section में unknown को warn माना जाता है। जब status pass या warn हो, तब ok true होता है। उत्तर देने वाले आवश्यक sections पर score 0 से 100 तक होता है, और जब errors और unknowns के कारण लागू भार के आधे से कम का उत्तर मिलता है, तब यह null होता है। mta_sts, tls_rpt, bimi, dnssec, dane, ns और registration की रिपोर्ट और तुलना की जाती है, लेकिन वे ok या score को प्रभावित नहीं करते।

कोई section pass, warn, fail, error (हम जाँच नहीं कर सके), unknown (निष्कर्ष के लिए बहुत कम जानकारी) या skipped (लागू नहीं होता) हो सकता है। skipped का परिणाम पर कोई प्रभाव नहीं पड़ता, और कारण not_checked में होता है। dkim_signature और alignment हमेशा मौजूद होते हैं, क्योंकि उनके लिए वास्तविक message चाहिए।

ip और selector क्या बदलते हैं

PTR और blocklists addresses से संबंधित होते हैं, इसलिए किसी run को कुछ addresses चाहिए। यह आपके दिए हुए ip values का उपयोग करता है। कोई value न होने पर, यह आपके MX hosts और मूल SPF record में मौजूद single-address ip4: और ip6: terms से अधिकतम चार addresses लेता है। किसी ज्ञात mail provider के addresses को managed के रूप में सूचीबद्ध करके उनकी जाँच नहीं की जाती, और कुछ भी शेष न रहने पर ptr और blocklist_ip का उत्तर skipped होता है। किसी selector को DNS से पढ़ा नहीं जा सकता, इसलिए run आपके selectors, आपके पिछले runs में मिले selectors और सामान्य names की सूची को आज़माता है। कुछ न मिलना कुछ भी सिद्ध नहीं करता, और dkim का उत्तर unknown होता है। यदि आप अपने server से भेजते हैं, तो दोनों दें।

क्या बदला

diff.changes की प्रत्येक प्रविष्टि में एक path, एक kind (added, removed, changed), एक severity (critical, warning, info) और एक effect (worsened, improved, neutral) होता है। केवल critical और warning diff.changed को सेट करते हैं, इसलिए समान लंबाई की बदली गई DKIM कुंजी, नया MX पता या नवीनीकृत प्रमाणपत्र cron लाइन को विफल नहीं करता। diff.worsened किसी भी बदलाव के effect के अनुसार होता है। पहले रन पर तुलना करने के लिए कुछ नहीं होता, और diff.first_run यही बताता है।

baseline हमेशा आपका अपना run होता है, इसलिए आपके दो runs के बीच किसी और के द्वारा domain की जाँच करने से कुछ नहीं छिपता। इस बार जो कुछ भी हम नहीं पढ़ सके, वह अपने अंतिम ज्ञात value के साथ diff.not_compared में जाता है, जिसका अर्थ है कि outage के दौरान किया गया change lookup के फिर से काम करने पर दिखाई देता है। अलग ip या selector वाला run उसी series में रहता है, और जिन चीज़ों के बारे में उसने नहीं पूछा, उनकी भी तुलना नहीं की जाती।

निर्धारित जाँच में key क्यों इस्तेमाल करें

key के बिना आपका history आपके IP address के keyed hash से संबद्ध होता है, इसलिए address बदलने पर यह समाप्त हो जाता है, और एक address के पीछे मौजूद लोग इसे साझा करते हैं: किसी सहकर्मी का run आपके baseline को बदल देता है। Authorization: Bearer में personal API key के साथ history key का अनुसरण करता है। key वाले runs 365 दिनों तक रखे जाते हैं और केवल उसी key से खुलते हैं। key के बिना runs 30 दिनों तक रखे जाते हैं और उस run की id रखने वाला कोई भी व्यक्ति उन्हें खोल सकता है।

प्रति IP एक मिनट में 6 और एक दिन में 50 requests, या प्रति key 30 और 500। इससे अधिक होने पर उत्तर Retry-After के साथ 429 होता है। 60 सेकंड के भीतर समान request cache से आता है, cached: true के रूप में चिह्नित होता है, कोई run नहीं लिखता और गिना नहीं जाता। stored runs पढ़ने के लिए प्रति client एक मिनट में 120 requests की अनुमति है। Retry-After के साथ 503 का अर्थ है कि बहुत अधिक checks चल रहे हैं, या stored runs पढ़ते समय storage उपलब्ध नहीं है। 401 का अर्थ गलत key है। 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}
   }

एंडपॉइंट