🛡️ fraudshield-client

Official lightweight JavaScript/TypeScript SDK for FraudShield, the enterprise email verification, disposable/burner email detection, and fraud risk scoring API on RapidAPI.

⚡ What FraudShield Does

• 🚫 Blocks Disposable Emails: Real-time detection of thousands of temporary burner providers (10minutemail, GuerrillaMail, Mailinator, Temp-Mail).
• 🌐 Live DNS-over-HTTPS MX Checks: Verifies actual mail exchange server availability via Cloudflare 1.1.1.1 & Google DNS without UDP socket latency.
• ✏️ Typo Suggestions: Catches common domain typos (gmial.com, hotmial.com) and suggests corrections.
• 🏢 Role & Webmail Classification: Identifies departmental addresses (billing@, support@, admin@) and free consumer webmail.
• 📊 Risk Scoring (0–100): Clear deliverability verdicts: deliverable, risky, undeliverable, or disposable.

📦 Installation

npm install fraudshield-client

🚀 Quickstart

1. Get an API Key

Subscribe to the free tier (100 calls/month included) on RapidAPI and copy your X-RapidAPI-Key.

2. Verify a Single Email

import { FraudShield } from 'fraudshield-client';

const client = new FraudShield({
  apiKey: 'YOUR_RAPIDAPI_KEY'
});

const result = await client.verify('[email protected]');

console.log(result.verdict);        // 'disposable'
console.log(result.risk_score);     // 90
console.log(result.is_disposable);  // true
console.log(result.flags);          // ['DISPOSABLE_EMAIL_DOMAIN']

3. Batch Verification (Up to 50 Concurrent)

const batch = await client.batchVerify([
  '[email protected]',
  '[email protected]',
  '[email protected]'
]);

console.log(`Processed ${batch.total} emails in ${batch.total_latency_ms}ms`);

📄 License

MIT License. Free for commercial and private use.