The Email Deliverability API helps businesses and developers evaluate the readiness of email domains to ensure successful email communication. It analyzes DNS records such as SPF, DKIM, DMARC, and PTR, providing insights into a domain's email configuration to enhance security and deliverability.
Choose the right plan for your email deliverability needs with flexible pricing options
1,000 Requests / Month
10,000 Requests / Month
100,000 Requests / Month
250,000 Requests / Month
The Email Deliverability API provides comprehensive analysis of email domain configurations to improve deliverability and security. This documentation outlines how to integrate and use the API effectively.
Click the button below to run and test this API with Postman:
Analyzes DNS records of a domain (SPF, DKIM, DMARC, PTR) and provides a deliverability score along with actionable improvements.
| Parameter | Type | Description |
|---|---|---|
domain |
string | The domain name to evaluate (required) |
ip |
string | The IP address for PTR record validation (optional) |
GET /v1/check?domain=example.com HTTP/1.1
Host: email-deliverability-api.p.rapidapi.com
X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
X-RapidAPI-Host: email-deliverability-api.p.rapidapi.com{
"domain": "example.com",
"score": 85,
"improvements": [
"Add a valid DKIM record to help verify the sender's identity.",
"Configure a valid reverse DNS (PTR) record for better server reputation."
],
"dns": {
"spf": "v=spf1 include:_spf.example.com ~all",
"dkim": {
"default": "v=DKIM1; k=rsa; p=..."
},
"dmarc": "v=DMARC1; p=none; rua=mailto:[email protected]"
},
"dns_results": {
"spf": true,
"dkim": true,
"dmarc": true
},
"reverse_dns": "mail.example.com",
"ip_in_spf": true
}| Property | Type | Description |
|---|---|---|
domain |
string | The domain that was checked |
score |
integer | Overall deliverability score from 0-100 |
spf |
object | SPF record information and validation results |
dkim |
object | DKIM record information and validation results |
dmarc |
object | DMARC record information and validation results |
ptr |
object | PTR record information and validation results |
improvements |
array | List of suggested improvements for email deliverability |
400 Bad Request: Missing required parameters or invalid domain500 Internal Server Error: An error occurred while processing the requestAssess domain readiness to improve the likelihood of successful email delivery.
Ensure SPF, DKIM, and DMARC records are configured correctly to prevent email spoofing and phishing.
Confirm that email domains follow best practices in email security and server configuration.
const axios = require('axios');
const options = {
method: 'GET',
url: 'https://email-deliverability-api.p.rapidapi.com/deliverability',
params: {domain: 'example.com'},
headers: {
'X-RapidAPI-Key': 'YOUR_API_KEY',
'X-RapidAPI-Host': 'email-deliverability-api.p.rapidapi.com'
}
};
try {
const response = await axios.request(options);
console.log(response.data);
} catch (error) {
console.error(error);
}import requests
url = "https://email-deliverability-api.p.rapidapi.com/deliverability"
querystring = {"domain":"example.com"}
headers = {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "email-deliverability-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())The current version of the Email Deliverability API is v1. We maintain backward compatibility for all minor updates within the same major version. Major version changes may include breaking changes.
| Version | Status | Changes |
|---|---|---|
v1 |
Current | Initial release with core functionality |
We will notify users at least 90 days before any deprecation of API versions.
SPF (Sender Policy Framework) records specify which servers are authorized to send emails from your domain, helping prevent email spoofing. DKIM (DomainKeys Identified Mail) adds a digital signature to emails, verifying they haven't been tampered with in transit. DMARC (Domain-based Message Authentication, Reporting & Conformance) specifies how receiving servers should handle emails that fail SPF or DKIM checks, providing an extra layer of protection against phishing and spoofing.
The deliverability score is calculated based on the presence and proper configuration of essential DNS records (SPF, DKIM, DMARC), the validity of PTR records, and the overall health of the domain's email infrastructure. The score ranges from 0-100, with higher scores indicating better deliverability prospects. Each component contributes to the overall score, with properly configured security records significantly boosting the rating.
A PTR (Pointer) record, also known as reverse DNS, maps an IP address back to a domain name. Many email servers check PTR records to verify that incoming messages are coming from legitimate servers. Without a valid PTR record, your emails may be flagged as spam or rejected entirely by receiving servers. The PTR record should match the domain used in your email's HELO/EHLO commands for best deliverability results.
The API provides specific improvement suggestions based on your domain's current configuration. To implement these improvements, you'll typically need to add or modify DNS records through your domain registrar or DNS hosting provider. For SPF, DKIM, and DMARC records, you'll need to add TXT records with specific formats. For PTR records, you may need to contact your email hosting provider or ISP, as these records are typically managed at the IP level rather than the domain level.
It's recommended to check your domain's deliverability at least monthly, especially for businesses that rely heavily on email communication. Additionally, you should check after making any changes to your email infrastructure, DNS records, or when switching email service providers. Regular monitoring helps ensure that your email configuration remains optimal and allows you to quickly address any issues that might affect deliverability.
Connect our powerful APIs with your favorite platforms for seamless workflow automation
Connect with 3,000+ apps
Create complex automation workflows
Microsoft's enterprise automation
Open-source workflow automation
Want to see us integrate with your favorite platform? Let us know!