Inbox-Placement-API.

Liste die Postfächer auf, die du testen willst, leg einen Placement-Test an, schick deine E-Mail an jede zurückgegebene Adresse und lies dann pro Postfach aus, in welchem Ordner sie gelandet ist (Posteingang / Werbung / Spam), samt Absender-Forensik und Blacklist-Treffern als JSON.

GET + POST /ext/v2/inbox-placement
curl https://api.unspam.email/ext/v2/inbox-placement/mailboxes \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
[
  { "id": 3,  "name": "Gmail",    "address": "..." },
  { "id": 7,  "name": "Outlook",  "address": "..." },
  ...
]

# pick the IDs you want to test,
# pass them in the next request.
curl -X POST https://api.unspam.email/ext/v2/inbox-placement \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "mailboxes": [3] }'

# response (201)
{
  "id": "abc123",
  "mailboxes": [
    { "id": 3, "name": "Gmail", "address": "..." }
  ]
}

# send your email to each address,
# with the test id somewhere in the body.
curl https://api.unspam.email/ext/v2/inbox-placement/abc123 \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "id": "abc123",
  "status": "completed",
  "results": [
    {
      "mailbox": { "name": "Gmail", ... },
      "status":     "delivered",
      "tab":        "inbox",
      "sender_ip":  "192.0.2.1",
      "blacklists": 0
    }
  ],
  "report_url": "https://unspam.email/inbox-test/abc123"
}

Vier Request-Typen. Ein API-Key.

Ein Key deckt alle vier Endpoints ab. POST /inbox-placement legt deine Nachricht in unsere Test-Postfächer und gibt pro Postfach zurück, in welchem Ordner sie landet; derselbe Key bewertet auch Inhalte, holt Client-Vorschauen und erzeugt Heatmaps.

Spam-Tests

POST /spam-checkScore, Absender-Forensik, Aufschlüsselung pro Check. Gebaut für Versandplattformen und CRM-Teams.

Inbox Placement

POST /inbox-placementAn unsere Test-Postfächer senden und pro Postfach den Ordner (Posteingang / Werbung / Spam) plus Blacklist-Treffer bekommen.

Client-Vorschauen

GET /spam-check/{id}/client-previewsRendering deiner E-Mail in über 50 echten Clients und auf echten Geräten, hell und dunkel. Mehr dazu bei der E-Mail-Vorschau-API.

E-Mail-Heatmaps

GET /spam-check/{id}/heatmapKI-generierte Heatmaps zu Fokus und Aufmerksamkeit für alle drei Gerätegrößen.

Warum Teams für Placement-Monitoring auf Unspam setzen.

Alle Postfächer testen oder eine Teilmenge wählen.

Übergib {"mailboxes": [3, 7, 23]}, um einen Test auf bestimmte Anbieter zu begrenzen. Lass den Body leer, um an jedes aktive Postfach zu senden. Die Postfach-IDs kommen aus GET /inbox-placement/mailboxes.

Posteingang / Werbung / Spam pro Anbieter.

Das Array results[] enthält einen Eintrag pro Postfach: den status der Zustellung, den Ziel-tab, sender und sender_ip, die der Empfänger gesehen hat, und die Anzahl der öffentlichen Blacklists.

Planen, abfragen, alarmieren.

Häng geplante Placement-Tests in deinen Monitoring-Stack. Leite die JSON-Response an Datadog, PagerDuty, Slack oder das Tool weiter, das dein Team ohnehin schon alarmiert.

Placement über die Zeit verfolgen.

Frühere Tests bleiben gespeichert. GET /inbox-placement?page=N&per_page=15 gibt die paginierte Liste mit id, status, Zeitstempeln und der gehosteten report_url zurück. Verfolge die Entwicklung pro Postfach von Woche zu Woche, ohne bei dir eine eigene Speicherung zu bauen.

Was jeder Inbox-Placement-Test zurückgibt.

Ein Ordner-Ergebnis pro Postfach, Absender-Forensik und Blacklist-Treffer: die Daten, mit denen dein Monitoring-Stack handeln kann.

01

Ein Ordner-Ergebnis pro Postfach, kein Score.

Das Feld results[].tab zeigt für jeden einzelnen Anbieter, wo die E-Mail gelandet ist: "inbox", "promotions", "spam" oder "missing". Aggregierte Scores verbergen, wo der Reputationsschaden tatsächlich entsteht. Das hier beantwortet die Frage direkt.

Das Feld status zeigt die Zustellung: "delivered", "pending" oder "missing", wenn das Test-Postfach die Nachricht überhaupt nie bekommen hat.

  • Gmail Posteingang
  • Outlook Werbung
  • Yahoo Mail Spam
  • Zoho Posteingang
  • AOL Posteingang
02

Absender- und SMTP-Forensik im selben Payload.

Jeder Ergebniseintrag enthält sender, sender_ip und blacklists (die Anzahl der öffentlichen Blacklists, auf denen unsere Engine die sendende IP zum Zustellzeitpunkt gefunden hat). Du siehst, was der Empfänger gesehen hat, nicht nur, was in deinen eigenen Logs steht.

Leite diese Werte direkt in dein Reputations-Dashboard oder drossle damit eine problematische IP, bevor sie die nächste Kampagne trifft.

ZUGESTELLT
status
delivered
tab
inbox
sender
send@yourdomain.com
sender_ip
192.0.2.1
blacklists
0
03

Auf die Anbieter filtern, die deine Kunden nutzen.

GET /ext/v2/inbox-placement/mailboxes gibt jedes aktive Postfach mit id, name und der aktiven address zurück. Wähl die IDs, die zu deiner Zielgruppe passen, und übergib sie an den Endpoint, der den Test anlegt.

Ein B2B-SaaS, das vor allem an Outlook im Unternehmen sendet, muss nicht jeden Anbieter mittesten. Grenz eng ein und spar dir dein Limit.

  • Gmail id: 1
  • Gmail Workspace id: 3
  • Outlook id: 7
  • Yahoo Mail id: 12
  • Zoho id: 18
  • AOL id: 23

So funktioniert die API in vier Schritten.

Inbox Placement läuft asynchron: Postfächer auflisten, Test anlegen, deine E-Mail an jede zurückgegebene Adresse schicken, dann die Ergebnisse pro Anbieter auslesen.

  1. 01

    Verfügbare Postfächer auflisten

    GET /ext/v2/inbox-placement/mailboxes gibt alle aktiven Postfächer mit stabilen IDs zurück. Einmal beim Setup nützlich, danach turnusmäßig, sobald neue Anbieter dazukommen.

  2. 02

    Placement-Test anlegen

    POST /ext/v2/inbox-placement mit optionalem mailboxes-Filter. Die 201-Response liefert die Test-id und die Liste der Postfächer mit der address, an die du zustellen musst.

  3. 03

    E-Mail an jede Adresse schicken

    Stell aus deiner Plattform an jede zurückgegebene Adresse zu. Pack die Test-id irgendwo in den E-Mail-Body, damit unsere Engine die Nachricht dem Test zuordnen kann.

  4. 04

    Ergebnisse pro Postfach auslesen

    GET /ext/v2/inbox-placement/{id} gibt das Array results[] mit tab, status, sender_ip und der blacklists-Anzahl pro Postfach zurück, sobald status === "completed" gilt.

Häufige Fragen zur API.

Wie die Postfächer funktionieren, Polling, Rate Limits und was das Ergebnis pro Anbieter bedeutet.

Wie bekomme ich API-Zugang?
API-Zugang gibt es in unserem White-Label-Plan, der komplett individuell ist: Die Limits für Inbox-Placement-Tests, Spam-Tests, Screenshots und Heatmaps werden auf dein Konto zugeschnitten. Sprich mit dem Vertrieb und nenne dein erwartetes Volumen, dann schneiden wir es passend zu.
Wie sehen die Rate Limits aus?
Das öffentliche Limit liegt bei 100 Requests pro Minute pro IP oder pro authentifiziertem Konto. Das deckt den meisten Produktions-Traffic ab. Wenn du mehr Burst-Kapazität oder eine eigene Leitung brauchst, öffne den Chat und nenne deinen erwarteten Durchsatz.
Wie läuft der Ablauf aus Anlegen und Senden ab?
Drei Aufrufe. POST /ext/v2/inbox-placement gibt eine Test-id und eine Liste von Postfach-Adressen zurück. Deine Plattform stellt die echte E-Mail an jede davon zu (mit der Test-id im Body, damit wir sie zuordnen können). Danach liefert GET /ext/v2/inbox-placement/{id} die Ergebnisse pro Postfach, sobald status === "completed" gilt.
Welche Postfächer stehen zur Verfügung?
Wir testen gegen die verbreitetsten privaten und geschäftlichen E-Mail-Anbieter. Die immer aktuelle Liste (samt der IDs, mit denen du einen Test eingrenzt) holst du über GET /ext/v2/inbox-placement/mailboxes.
Ist das Placement deterministisch?
Nein. Die Filter der Anbieter arbeiten stichprobenbasiert und hängen von der Absender-Reputation, dem Engagement der Empfänger und den aktuellen Filtergewichten ab. Nimm das Ergebnis als starken Richtungswert, nicht als Garantie, dass künftige Sendungen im selben Ordner landen.
Was sagt mir die Blacklist-Anzahl?
Das Feld blacklists in jedem Ergebnis ist die Anzahl der öffentlichen Blacklists, auf denen unsere Engine die sendende IP zum Zustellzeitpunkt gefunden hat. Null ist der Normalfall; alles darüber ist ein Reputationsproblem, das du über deinen Absender oder ESP klären solltest.
Kann ich frühere Tests auflisten?
Ja. GET /ext/v2/inbox-placement?page=1&per_page=15 gibt eine paginierte Liste der über die API erstellten Tests zurück, mit id, status, Zeitstempeln und der jeweiligen report_url.
Wie stoße ich Placement-Tests aus einer CI-Pipeline an?
Setz den POST in deinem Build-Schritt ab (curl, Node, Python oder ein beliebiger HTTP-Client). Lies die Response, schick deine E-Mail und frag dann GET /inbox-placement/{id} mit exponentiellem Back-off ab, bis status auf "completed" steht.

Hol Placement-Tests in deinen Stack.

API-Zugang ist im White-Label-Plan enthalten. Preise auf der öffentlichen Seite, individuelle Limits im Chat.

Preise ansehen