Email Validation API

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

Validate email addresses - check syntax, domain, MX records, SPF, DMARC, and deliverability. Detect disposable emails, free providers, and role-based addresses.

Features

Feature	Replaces	What It Does
Syntax Validation	Basic regex	RFC-compliant email format checking with detailed error messages
MX Record Check	Manual DNS lookup	Verify domain can actually receive emails
SPF/DMARC Detection	DNS tools	Check for email authentication records (higher deliverability)
Disposable Detection	EmailHippo, Kickbox	Flag 1,000+ temporary/throwaway email services
Free Provider Detection	Manual lists	Identify Gmail, Yahoo, Outlook, ProtonMail, etc.
Role-Based Detection	Manual patterns	Flag generic addresses (info@, support@, sales@, admin@)
Deliverability Score	Multiple tools	0-100 score combining all quality signals

---

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Required	Description
emails	string[]	Yes	List of email addresses to validate
checkMx	boolean	No	Verify MX records exist (default: true)
checkSmtp	boolean	No	Attempt SMTP verification (default: false)
checkDisposable	boolean	No	Flag disposable emails (default: true)
webhookUrl	string	No	Webhook URL for async results
demoMode	boolean	No	Return sample data without validation

---

Output Format

Each validated email returns structured JSON:

{
  "email": "john.doe@gmail.com",
  "isValid": true,
  "syntax": {
    "isValid": true,
    "localPart": "john.doe",
    "domain": "gmail.com"
  },
  "domain": {
    "name": "gmail.com",
    "hasMx": true,
    "mxRecords": [
      {"exchange": "gmail-smtp-in.l.google.com", "priority": 5}
    ],
    "hasSpf": true,
    "hasDmarc": true
  },
  "deliverability": {
    "isDeliverable": true,
    "reason": null
  },
  "flags": {
    "isDisposable": false,
    "isFreeProvider": true,
    "isRoleBased": false,
    "isCatchAll": null
  },
  "score": 95,
  "checkedAt": "2025-12-23T12:00:00.000Z"
}

---

Pricing

This actor uses pay-per-event billing:

• data_point: $0.01 per result

Use Cases

Lead Generation & Sales

• List cleaning: Validate purchased lists before campaigns
• Form validation: Real-time validation at point of entry
• CRM hygiene: Maintain clean customer databases
• Bounce prevention: Avoid damaging sender reputation

Marketing Agencies

• Campaign prep: Clean client lists before sends
• Deliverability optimization: Improve open rates
• List monetization: Validate before selling leads

E-commerce & SaaS

• Signup validation: Reduce fake accounts
• Fraud prevention: Detect disposable emails
• Customer verification: Ensure valid contact info

Developers

• API integration: RESTful JSON responses
• Webhook support: Async processing for large lists
• Batch processing: Validate thousands in parallel

---

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal