API Documentation

Integrate EmailFinder's powerful verification and extraction capabilities into your applications with our comprehensive RESTful API.

Get API Keys Quick Start

API Overview

Base URL

https://api.emailfinder.com/v1

Authentication

All API requests require authentication using your API key in the header:

Authorization: Bearer YOUR_API_KEY Content-Type: application/json

Quick Start

1. Single Email Verification

curl -X POST https://api.emailfinder.com/v1/verify-email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "test@example.com"
  }'
                        

2. Domain Email Extraction

curl -X POST https://api.emailfinder.com/v1/extract-emails \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "limit": 50
  }'
                        

API Endpoints

POST /verify-email

Verify a single email address for deliverability and validity.

Request Body:

{
"email": "string" // Required: Email address to verify
}

Response:

{
"email": "test@example.com",
"is_valid": true,
"is_deliverable": true,
"score": 95,
"status": "valid"
}
POST /extract-emails

Extract email addresses from a domain or website.

Request Body:

{
"domain": "string", // Required: Domain to extract from
"limit": 50, // Optional: Max emails to extract
"verify": true // Optional: Auto-verify extracted emails
}

Response:

{
"job_id": "abc123",
"status": "processing",
"domain": "example.com",
"estimated_time": "2-3 minutes"
}
POST /bulk/verify-emails

Verify multiple email addresses in bulk.

Request Body:

{
"emails": ["email1@example.com", "email2@example.com"],
"webhook_url": "https://yoursite.com/webhook" // Optional
}
GET /bulk/status/{job_id}

Check the status of a bulk processing job.

Response:

{
"job_id": "abc123",
"status": "completed",
"progress": 100,
"total_emails": 1000,
"processed": 1000,
"valid_emails": 850
}

⚠️ Rate Limits

  • Free Plan: 10 requests/hour
  • Professional: 100 requests/hour
  • Enterprise: 1000 requests/hour

SDKs & Libraries

PHP SDK

composer install emailfinder/php-sdk

Python SDK

pip install emailfinder-python

Node.js SDK

npm install emailfinder-js

Need Help?

Our support team is here to help you integrate our API successfully.

Contact Support