Email Intelligence API

Try It Now

Click the button below to run and test this API with Postman:

Base URL

https://email-intelligence-api.p.rapidapi.com

Authentication

All requests to the Email Intelligence API require authentication. Include your RapidAPI credentials in the request headers:

{
  "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
  "X-RapidAPI-Host": "email-intelligence-api.p.rapidapi.com"
}

You can obtain your API key by subscribing to the Email Intelligence API on RapidAPI.

GET /v1/check

Retrieves comprehensive information about an email address including its validity, domain details, DNS records, temporary email status, aliasing information, website availability, deliverability score, and risk indicator.

Query Parameters

Example Request

GET /v1/[email protected] HTTP/1.1
Host: email-intelligence-api.p.rapidapi.com
X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
X-RapidAPI-Host: email-intelligence-api.p.rapidapi.com

Example Response

{
  "status": true,
  "data": {
    "email": "[email protected]",
    "domain": "gmail.com",
    "alias": {
      "main": "test",
      "alias": "alias"
    },
    "is_subdomain": false,
    "is_valid": true,
    "is_temp_email": false,
    "is_gov": false,
    "is_edu": false,
    "has_valid_mx_records": true,
    "records": {
      "mx": [
        {
          "exchange": "alt1.aspmx.l.google.com",
          "priority": 5
        }
      ],
      "spf": "v=spf1 include:_spf.google.com ~all",
      "dmarc": "v=DMARC1; p=none; rua=mailto:[email protected]"
    },
    "smtp": {
      "provider": "alt1.aspmx.l.google.com",
      "addresses": [
        {
          "exchange": "alt1.aspmx.l.google.com",
          "priority": 5
        }
      ]
    },
    "email_provider": {
      "name": "google",
      "provider": "Google"
    },
    "website": {
      "url": "http://gmail.com",
      "is_valid": true,
      "ssl": true
    },
    "deliverability_score": 85,
    "risk_indicator": "low"
  }
}

Response Fields

• email: The provided email address
• domain: The domain part extracted from the email address
• alias: Information about email aliases (if present)
• is_valid: Boolean indicating if the email format is valid
• is_temp_email: Boolean indicating if it's a temporary email
• records: DNS records (MX, SPF, DMARC)
• deliverability_score: Score from 0-100
• risk_indicator: Risk assessment (low, medium, high)

Error Handling

The API uses standard HTTP status codes to indicate the success or failure of requests:

Error responses include additional details about what went wrong:

{
  "error": {
    "message": "Missing required parameter: email",
    "code": "MISSING_PARAM",
    "status": 400
  }
}

Rate Limits

API rate limits vary by subscription plan:

• Basic: 1,000 requests per month, maximum 10 requests per second
• Pro: 25,000 requests per month, maximum 25 requests per second
• Ultra: 100,000 requests per month, maximum 50 requests per second
• Mega: 250,000 requests per month, maximum 100 requests per second

When you exceed your rate limit, the API will return a 429 status code. Implement exponential backoff or queuing mechanisms to handle rate limiting gracefully.

Best Practices

• Validate at critical points: Implement email validation at user registration, checkout processes, and lead generation forms.
• Implement caching: Cache validation results for frequently checked email addresses to reduce API calls.
• Handle temporary conditions: DNS and SMTP servers can occasionally be unavailable. Implement retry logic with increasing delays.
• Create tiered validation: Start with basic syntax validation client-side before making API calls for deeper validation.
• Process results intelligently: Instead of simply rejecting emails with issues, use the risk scores to implement appropriate user workflows (e.g., additional verification for medium-risk emails).

API Versioning

The current version of the Email Intelligence API is v1. We maintain backward compatibility for all minor updates within a major version.

We announce API updates and changes through our documentation and via email to active users. Major version changes will be announced at least 6 months in advance.

Integration Examples

const axios = require('axios');

const options = {
  method: 'GET',
  url: 'https://email-intelligence-api.p.rapidapi.com/v1/check',
  params: { email: '[email protected]' },
  headers: {
    'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY',
    'X-RapidAPI-Host': 'email-intelligence-api.p.rapidapi.com'
  }
};

try {
  const response = await axios.request(options);
  
  // Handle valid email
  if (response.data.data.is_valid) {
    console.log('Email is valid!');
    
    // Check risk level
    if (response.data.data.risk_indicator === 'low') {
      // Proceed with low-risk email
    } else if (response.data.data.risk_indicator === 'medium') {
      // Add additional verification
    } else {
      // High-risk handling
    }
  } else {
    console.log('Email is invalid');
  }
} catch (error) {
  console.error('Error validating email:', error);
  
  // Handle rate limiting
  if (error.response && error.response.status === 429) {
    // Implement retry with exponential backoff
  }
}

import requests
import backoff

# Example with exponential backoff for rate limiting
@backoff.on_exception(backoff.expo, requests.exceptions.RequestException, max_tries=5)
def validate_email(email):
    url = "https://email-intelligence-api.p.rapidapi.com/v1/check"
    querystring = {"email": email}
    headers = {
        "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
        "X-RapidAPI-Host": "email-intelligence-api.p.rapidapi.com"
    }
    
    response = requests.get(url, headers=headers, params=querystring)
    response.raise_for_status()  # Will trigger backoff on 429 errors
    
    data = response.json()
    
    if data['data']['is_valid']:
        print(f"Email {email} is valid")
        print(f"Deliverability score: {data['data']['deliverability_score']}")
        return data['data']
    else:
        print(f"Email {email} is invalid")
        return None

try:
    result = validate_email("[email protected]")
except Exception as e:
    print(f"Error validating email: {e}")