Entwickler-API

Die EmailDeliverabilityReport-API ist eine Schnittstelle für aktuelle Statistiken und ermöglicht den direkten Zugriff auf unsere Daten in der zentralen Datenbank zu der E-Mail-Zustellbarkeit, Reputation von Mailservern und mehr.

Unsere Datenbank wird regelmäßig aktualisiert, sodass du immer die aktuellsten Daten über die API abfragen kannst.

Was du mit unserer API machen kannst

Du möchtest deine eigene Anwendung rund um E-Mail-Marketing-Statistiken, E-Mail-Zustellbarkeit oder Versender-Reputation aufbauen und benötigst aktuelle Daten?

Oder möchtest du wissen, wie sich die Zustellbarkeit von E-Mails bei Berücksichtigung der zahlreichen Branchen oder E-Mail-Dienstanbieter verändert, um Fallstudien, Statistiken oder Diagramme zu erstellen?

Vielleicht bist du ein Betreiber eines E-Mail-Marketing-Services, den wir hinsichtlich der Zustellbarkeit und Reputation testen und möchtest immer auf dem Laufenden sein, wie sich deine Infrastruktur im direkten Vergleich mit der Konkurrenz schlägt?

Nutze unsere hochverfügbare Schnittstelle, um sofort auf Daten zugreifen zu können, die wir durch sehr aufwendige Tests sammeln. Jeden Monat werten wir derzeit mehr als 100.000 E-Mails aus und sammeln dabei unter anderem Daten zur Zustellbarkeit von E-Mails.

Wie du unsere API nutzen kannst

Unsere aktuelle API-Version ist 1.0. Um Anfragen an die Schnittstelle zu senden, muss folgende durch SSL gesicherte URL verwendet werden:


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

Du bekommst einen persönlichen API-Schlüssel , nachdem deine Bewerbung für unsere API-Nutzung akzeptiert wurde. Der Schlüssel hat eine Länge von 32 Zeichen und muss sicher aufbewahrt werden.

Jede Anfrage wird mit einem JSON-String beantwortet. Im Erfolgsfall werden die Daten mit der Antwort gesendet. Im Fehlerfall werden der Fehler und ein Fehlercode genannt.

Um deine Anfrage zu spezialisieren, müssen an die URL zusätzliche Parameter angehängt werden, der wichtigste Parameter ist &action=. Alle Anfragen müssen mit einem Aktion-Parameter ausgestattet sein.

Folgende Aktionen unterstützt die aktuelle API-Version:

Aktion	Beschreibung
&action=get_providers	Erhalte alle Anbieter für E-Mail-Marketing-Services, die bei uns derzeit in der Datenbank sind und zu denen wir Daten erfassen.
Pflichtparameter
Keine
Zusatzparameter
&id=[1\|2\|...]	Die ID des Providers, um die Anfrage einzugrenzen.

Beispiel-Anfrage

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

Ausgabe (PHP)


			Array

			(

			  [0] => Array

			    (

			      [id] => 1

			      [name] => GetResponse

			      [provider_score] => 92

			      [deliverability_score] => 93

		        [reputation_score] => 87

			    )

			  [1] => ...

Aktion	Beschreibung
&action=get_provider_mailservers	Erhalte alle Mailserver eines Providers, die uns bekannt sind.
Pflichtparameter
&id=[1\|2\|...]	Die ID des Providers, um die Anfrage einzugrenzen. Die ID bekommt man, wenn man sich alle Provider mit der Aktion get_providers anzeigen lässt.
Zusatzparameter
Keine

Beispiel-Anfrage

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

Ausgabe (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] => ...

Aktion	Beschreibung
&action=get_stats	Erhalte alle E-Mail-Versand-Statistiken zu einem Anbieter. Unter anderem kann der Zeitraum für die Statistiken durch Zusatzparameter eingegrenzt werden.
Pflichtparameter
&provider_id=[1\|2\|...]	Die ID des Providers. Die ID bekommt man, wenn man sich alle Provider mit der Aktion get_providers anzeigen lässt.
Zusatzparameter
&email_service_id=[1\|2\|...]	Die ID des E-Mail-Dienstanbieters. Die ID bekommt man, wenn man sich alle E-Mail-Dienstanbieter mit der Aktion get_email_services anzeigen lässt.
&category_id=[1\|2\|...]	Die ID der Kategorie. Die ID bekommt man, wenn man sich alle Kategorien mit der Aktion get_categories anzeigen lässt.
&year=[2019\|2020...]	Eine vierstellige Zahl, die ein Jahr repräsentiert.
&month=[1\|2\|3]	Eine ein- bis zweistellige Zahl, die den Monat repräsentiert.

Beispiel-Anfrage

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

Ausgabe (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] => ...

Aktion	Beschreibung
&action=get_categories	Erhalte alle Kategorien und einige zusätzliche Informationen.
Pflichtparameter
Keine
Zusatzparameter
&id=[1\|2\|...]	Die ID der Kategorie, um die Anfrage einzugrenzen.

Beispiel-Anfrage

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

Ausgabe (PHP)


			Array

			(

			  [0] => Array

			    (

			      [id] => 1

			      [name] => Clothing

			    )

			  [1] => Array

			    (

			      [id] => 2

			      [name] => Elektronics

			    )

			  [2] => ...

Aktion	Beschreibung
&action=get_email_services	Erhalte alle E-Mail-Dienstanbieter und einige zusätzliche Informationen.
Pflichtparameter
Keine
Zusatzparameter
&id=[1\|2\|...]	Die ID des E-Mail-Dienstanbieters, um die Anfrage einzugrenzen.

Beispiel-Anfrage

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

Ausgabe (PHP)


			Array

			(

			  [0] => Array

			    (

			      [id] => 1

			      [name] => Gmail

			    )

			  [1] => Array

			    (

			      [id] => 2

			      [name] => Outlook Mail

			    )

			  [2] => ...

Sich zu unserer API bewerben

Wenn du unsere API nutzen möchtest, musst du dich bewerben. Wir möchten sicherstellen, dass wir nur mit den richtigen Geschäftspartnern arbeiten und gleichzeitig der richtige Partner für dein Projekt sind.

Wie die Bewerbung funktioniert

4 Schritte trennen dich von der Nutzung unserer Schnittstelle:

Du bewirbst dich per Bewerbungsformular und sendest uns einige Informationen zu deinem Projekt und zu dem Einsatzzweck unserer API.
Innerhalb von 7 Tagen überprüfen wir deine Bewerbung und teilen dir per E-Mail unsere Entscheidung mit.
Wird die Bewerbung akzeptiert, senden wir per E-Mail einen PayPal-Link an dich, damit du ein monatliches Abonnement mit PayPal zu deinem gewählten Tarif einrichten kannst.
Nachdem die erste Zahlung bei uns eingegangen ist, richten wir für dich einen Account für unser online API-Interface ein und senden dir deine Zugangsdaten per E-Mail, damit du die API nutzen kannst.

Die Bewerbung ist unverbindlich und wir können nicht garantieren, dass wir deine Bewerbung akzeptieren werden. In jedem Fall melden wir uns jedoch zurück, um auf die Bewerbung zu antworten.

Bewerbungsformular

Wählte im nachfolgenden Formular einen der verfügbaren Tarife aus und teile uns einige Informationen über den Einsatzzweck unserer API mit, damit wir wissen, wie und in welchem Umfang du unsere API nutzen möchtest.

Nachdem wir die Bewerbung erhalten haben, werden wir prüfen, ob unsere API für dein Projekt geeignet ist und ob wir eine Partnerschaft mit dir eingehen möchten. Innerhalb von 7 Tagen werden wir uns dann bei dir mit unserer Entscheidung zurückmelden.

Auf eine gute Zusammenarbeit für beide Seiten.