Sign In
Language

Developer API

The EmailDeliverabilityReport API is an interface for up-to-date statistics and allows direct access to our data in the central database on email deliverability, mail server reputation and more.

Our database is updated regularly, so you can always get the latest data via the API.

What you can do with our API

You want to build your own application around email marketing statistics, email deliverability or sender reputation and you need current data?

Or would you like to know how the deliverability of emails changes considering the numerous industries or email service providers in order to create case studies, statistics or diagrams?

Perhaps you are an operator of an email marketing service that we are testing for deliverability and reputation and would like to be always up to date on how well your infrastructure is doing in direct comparison with the competition?

Use our highly available interface to be able to immediately access data that we collect through very complex tests. We currently evaluate more than 150,000 emails every month, collecting data about reputation of email marketing providers and the deliverability of emails, among other things.

How you can use our API

Our current API version is 1.0. To send requests to the interface, the following SSL-secured URL must be used:

https://api.emaildeliverabilityreport.com/v1/request?api_key=***

You will receive a personal API key after your application for our API use has been accepted. The key has a length of 32 characters and must be kept safely.

Every query is answered with a JSON string. If successful, the data will be sent with the answer. In the case of an error, the error and an error code are named.

To specialize your request, additional parameters have to be added to the URL, the most important parameter is &action=. All requests must be equipped with an action parameter.

The current API version supports the following actions:

Action Description
&action=get_providers Receive all providers of email marketing services that are currently in our database and for which we collect data.
Required parameters
Keine
Additional parameters
&id=[1|2|...] The ID of the provider to narrow the query.

Example request

/v1/request?api_key=***&action=get_providers

Return (PHP)

Array
(
  [0] => Array
    (
      [id] => 1
      [name] => GetResponse
      [provider_score] => 92
      [deliverability_score] => 93
      [reputation_score] => 87
    )
  [1] => ...
Action Description
&action=get_provider_mailservers Receive all mail servers of a provider that we know.
Required parameters
&id=[1|2|...] The ID of the provider to narrow the query. You get the ID if you request all providers with the action get_providers.
Additional parameters
Keine

Example request

/v1/request?api_key=***&action=get_provider_mailservers&id=1

Return (PHP)

Array
(
  [0] => Array
    (
      [provider_id] => 1
      [hostname] => mta-15.gamma.getresponse-mail.com
      [ipv4] => 104.160.65.15
      [ipv6] =>
      [on_blacklists] => 0
    )
  [1] => Array
    (
      [provider_id] => 1
      [hostname] => mta-1.delta.getresponse-mail.com
      [ipv4] => 104.160.67.128
      [ipv6] =>
      [on_blacklists] => 0
    )
  [2] => ...
Action Description
&action=get_stats Get all email sending statistics from one provider. Among other things, the period for the statistics can be limited by additional parameters.
Required parameters
&provider_id=[1|2|...] The ID of the provider. You get the ID if you request all providers with the action get_providers.
Additional parameters
&email_service_id=[1|2|...] The email service provider ID. You get the ID if you request all email service providers with the action get_email_services.
&category_id=[1|2|...] The ID of the category. You get the ID if you request all categories with the action get_categories.
&year=[2019|2020...] A four-digit number that represents a year.
&month=[1|2|3] A one- to two-digit number that represents the month.

Example request

/v1/request?api_key=***&action=get_stats&provider_id=1&year=2020

Return (PHP)

Array
(
  [0] => Array
    (
      [provider_id] => 1
      [email_service_id] => 1
      [category_id] => 1
      [year] => 2020
      [month] => 1
      [volume] => 88
      [inbox] => 59
      [spam] => 28
      [lost] => 1
    )
  [1] => Array
    (
      [provider_id] => 1
      [email_service_id] => 2
      [category_id] => 1
      [year] => 2020
      [month] => 1
      [volume] => 60
      [inbox] => 41
      [spam] => 18
      [lost] => 1
    )
  [2] => ...
Action Description
&action=get_categories Receive all categories and some additional information.
Required parameters
Keine
Additional parameters
&id=[1|2|...] The ID of the category to narrow the query.

Example request

/v1/request?api_key=***&action=get_categories

Return (PHP)

Array
(
  [0] => Array
    (
      [id] => 1
      [name] => Clothing
    )
  [1] => Array
    (
      [id] => 2
      [name] => Elektronics
    )
  [2] => ...
Action Description
&action=get_email_services Receive all email service providers and some additional information.
Required parameters
Keine
Additional parameters
&id=[1|2|...] The email service provider's ID to narrow the query.

Example request

/v1/request?api_key=***&action=get_email_services

Return (PHP)

Array
(
  [0] => Array
    (
      [id] => 1
      [name] => Gmail
    )
  [1] => Array
    (
      [id] => 2
      [name] => Outlook Mail
    )
  [2] => ...

Apply to our API

If you want to use our API, you have to apply. We want to make sure that we only work with the right business partners and at the same time are the right partner for your project.

How the application works

4 steps separate you from using our interface:

  1. You apply by using the application form and send us some information about your project and the use purpose of our API.
  2. We will review your application within 7 days and notify you of our decision by email.
  3. If the application is accepted, we will send you a PayPal link by email so that you can set up a monthly subscription with PayPal for your chosen tariff.
  4. After we receive the first payment, we will set up an account for you for our online API interface and send you your login details by email so you can use the API.

The application is non-binding and we cannot guarantee that we will accept your application. In any case, we will get back to you in order to respond to the application.

Application form

In the following form, chose one of the available tariffs and provide us with some information about the use purpose of our API so that we know how and to what extent you would like to use our API.

After we have received the application, we will check whether our API is suitable for your project and whether we want to partner with you. We will then get back to you with our decision within 7 days.

On a good working relationship for both sides.