Documentation

Overview

EmailFinder is a comprehensive email intelligence platform that provides email verification and extraction services. Our platform helps businesses maintain clean email lists, improve deliverability, and find new prospects.

Key Features

• Email Verification: Validate email addresses with 99.5% accuracy
• Bulk Processing: Process thousands of emails simultaneously
• Domain Extraction: Find email addresses from company websites
• API Integration: Seamlessly integrate with your applications
• Real-time Processing: Get results in seconds

Quick Start

1. Create an Account

Sign up for a free account to get started with 100 free verifications per month.

2. Verify Your First Email

Use our web interface to verify a single email address and see how it works.

3. Try Bulk Verification

Upload a CSV file with multiple email addresses for bulk verification.

Authentication

To use the EmailFinder API, you need to authenticate using your API key. You can generate API keys from your account dashboard.

Getting Your API Key

1. Log in to your EmailFinder account
2. Navigate to API Keys
3. Click "Generate New Key"
4. Copy your API key and keep it secure

Using Your API Key

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.emailfinder.com/v1/verify-email
                            

Single Email Verification

Verify a single email address to check its validity and deliverability.

Web Interface

Use our Email Verifier page to verify emails through a simple web interface.

API Request

POST /v1/verify-email
{
  "email": "test@example.com"
}
                            

Response

{
  "email": "test@example.com",
  "is_valid": true,
  "is_deliverable": true,
  "score": 95,
  "status": "valid",
  "reason": "Valid email address"
}
                            

Bulk Email Verification

Process multiple email addresses at once using our bulk verification service.

Supported File Formats

• CSV files with email column
• Excel files (.xlsx) with email column
• Text files with one email per line

File Requirements

• Maximum file size: 50MB
• Maximum emails per file: 100,000
• Email column should be labeled "email" or "Email"

Domain Email Extraction

Extract email addresses from company websites and domains automatically.

How It Works

1. Enter a domain name (e.g., company.com)
2. Our crawler scans the website for email patterns
3. Emails are automatically verified during extraction
4. Results are filtered and deduplicated
5. Export in your preferred format

Extraction Sources

• Contact pages and forms
• About us and team pages
• Footer and header information
• Social media links and profiles
• Public employee directories

Webhooks

Get real-time notifications when your bulk jobs are completed using webhooks.

Setting Up Webhooks

1. Provide a webhook URL when starting a bulk job
2. Ensure your endpoint can handle POST requests
3. Respond with a 200 status code to confirm receipt

Webhook Payload

{
  "job_id": "abc123",
  "status": "completed",
  "total_emails": 1000,
  "valid_emails": 850,
  "invalid_emails": 150,
  "completed_at": "2024-01-15T10:30:00Z"
}
                            

Troubleshooting

Common Issues

Best Practices

Email List Hygiene

• Verify emails before sending campaigns
• Remove invalid emails promptly
• Regularly clean your email lists
• Monitor bounce rates and engagement

API Usage

• Implement proper error handling
• Respect rate limits to avoid throttling
• Use webhooks for bulk processing notifications
• Cache results when appropriate

Compliance

• Obtain proper consent before collecting emails
• Follow GDPR and privacy regulations
• Provide unsubscribe options in emails
• Respect email owner preferences