Official Library

Node.js Email Verification SDK

The official Node.js client for EmailVerify.io, providing stable, high-performance email validation and lead discovery tools. Optimized for modern JS environments with full TypeScript support and async/await compatibility.

Get API Key

Free plan available. No credit card required.

sdk-example.worker

NPM Installation

Install the EmailVerify Node.js SDK via npm or yarn.

terminal


                npm install emailverify-sdk

Developer Guide

1 Standard Verification

Official Node.js client for real-time SMTP verification. Fully async/await compatible for seamless integration into Express, NestJS, or any modern JS environment.

javascript

const { EmailVerify } = require('emailverify-sdk');
const client = new EmailVerify('your_api_key');

async function checkEmail() {
  const result = await client.verify('[email protected]');
  console.log(result.isValid ? 'Deliverable' : 'Bounce');
}

2 High-Throughput Batch API

Process lists of any size. Our batch engine handles concurrency and retries automatically, giving you verified results with minimal infrastructure overhead.

javascript

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

// Check progress
const status = await client.getBatchStatus(batch.id);
if (status.percent === 100) {
  const results = await client.getBatchResults(batch.id);
  console.log(results);
}

3 Custom Client Configuration

Tailor the SDK to your needs. Configure custom timeouts, retry strategies, and proxy settings for enterprise-grade reliability and security.

javascript

const client = new EmailVerify('key', {
  timeout: 5000,    // 5 second timeout
  retryCount: 3,    // Auto-retry on 5xx errors
  userAgent: 'MyEnterpriseApp/1.0',
  proxy: 'http://proxy:8080'
});

4 Professional Finder API

Discover professional email addresses from names and domains. Backed by multi-layered verification to ensure your outreach reaches the inbox.

javascript

const result = await client.finder.find({
  firstName: 'Elon',
  lastName: 'Musk',
  domain: 'tesla.com'
});

if (result.email) {
  console.log(`Verified Email: ${result.email}`);
}

5 Smart Syntax Validation

Stop typos before they bounce. Automatically detect common spelling errors and provide instant suggestions to your users during registration.

javascript

const { isSyntaxValid, suggestion } = client.validateSyntax('[email protected]');
if (suggestion) {
  console.log(`Did you mean ${suggestion}?`); // [email protected]
}

6 Native TypeScript Support

Built with TypeScript for a superior developer experience. Enjoy full type safety and autocompletion for all verification responses and configurations.

javascript

import { EmailVerify, VerificationResult } from 'emailverify-sdk';

const client = new EmailVerify('key');
const res: VerificationResult = await client.verify('[email protected]');
console.log(res.score);

7 Advanced Error Resilience

Build bulletproof applications. The SDK includes specific error classes for rate limits and network issues, making it easy to implement robust recovery logic.

javascript

try {
  await client.verify('[email protected]');
} catch (err) {
  if (err instanceof EmailVerify.RateLimitError) {
    // Wait and retry
  } else if (err instanceof EmailVerify.NetworkError) {
    // Check connection
  }
}

8 Disposable & Bot Detection

Protect your platform from low-quality sign-ups. Identify temporary email services and suspected bots in real-time before they impact your metrics.

javascript

const res = await client.verify('[email protected]');
if (res.isDisposable) {
  console.log('Temporary email detected.');
}
if (res.isBot) {
  console.log('Suspected automated sign-up.');
}

FAQs

Frequently Asked Questions

Is the Node.js SDK async/await ready?

Absolutely. All network-bound methods return Promises, making it perfect for modern async workflows.

Can I use it in the browser?

The SDK is designed for server-side use to protect your API key. For client-side validation, use our secure API endpoints via your backend.

Does it support CommonJS and ESM?

Yes, the package is compiled to support both `require` and `import` syntax.

How are rate limits handled?

The SDK provides clear error types when limits are hit, allowing you to implement your own back-off or queuing logic.

You're just one click away from clean email lists.

Start verifying your email addresses instantly and improve your campaign deliverability

Talk to Sales

* No credit card required