# Adressprüfung per API: Anbieter wählen, richtig testen

> Eine Adressprüfung per API gleicht eine Anschrift mit Referenzdaten ab und liefert eine korrigierte Fassung samt Urteil: wie genau der Treffer ist, was ergänzt oder ersetzt wurde und ob die Adresse zustellbar wirkt. Wähle nach Länderabdeckung, Genauigkeit bis zur Wohnung, Preis bei deinem Volumen und den Bedingungen zur Datenverarbeitung.

- URL: https://address-valid.com/de/validierung/adresspruefung-api/
- Sprache: de
- Aktualisiert: 2026-10-19
- Herausgeber: AddressValid (OnlineBuilders LLC, https://onlinebuilders.biz)

Die Deutsche Post Direkt hat für ihre Adress-Studie 2025 Kundenadressen in deutschen Unternehmen untersucht. Ergebnis: 13,2 Prozent waren fehlerhaft, zwei Jahre zuvor waren es 12,6 Prozent. Jede achte Adresse also. Eine API, die Anschriften schon bei der Eingabe prüft, ist die naheliegende Antwort, und der Markt dafür ist groß genug, dass sich ein genauer Blick lohnt.

## Was eine Prüf-API zurückgibt

Die Antwort ist mehr als „gültig“ oder „ungültig“. Googles Address Validation API ist gut dokumentiert und taugt deshalb als Beispiel. Die [Beschreibung der Antwort](https://developers.google.com/maps/documentation/address-validation/understand-response) nennt im Feld `verdict` unter anderem:

| Feld | Bedeutung |
|---|---|
| `validationGranularity` | Genaueste geprüfte Ebene; `PREMISE` oder `SUB_PREMISE` spricht für Zustellbarkeit |
| `addressComplete` | Wahr, wenn nichts fehlt, offen bleibt oder unerwartet ist |
| `hasUnconfirmedComponents` | Teile ließen sich nicht bestätigen |
| `hasInferredComponents` | Die API hat Teile ergänzt |
| `possibleNextAction` | Kurzempfehlung, etwa `ACCEPT` |

Für US-Adressen kommt ein Code aus der USPS-Zustellpunktprüfung dazu: Y bestätigt, D Wohnung fehlt, S Wohnung angegeben, aber nicht bestätigt, N nicht bestätigt. Google rät selbst davon ab, Logik an einzelnen Bestätigungsstufen pro Adressteil festzumachen. Der Rat gilt für jeden Anbieter: Entscheide nach dem Gesamturteil.

## Drei Arten von Anbietern

**Anbietertypen für die Adressprüfung**

| | Globale Kartenplattform | Postdaten-Händler | Produkt eines Postunternehmens |
|---|---|---|---|
| Datenbasis | Eigene Karten- und Adressdaten | Lizenzierte Postdateien | Eigene Referenzdatei |
| Länder | Viele | Ein bis wenige | Eins |
| Genauigkeit bis Wohnung | teilweise | ja | ja |
| Preismodell | Öffentliche Preisliste | Vertrag oder Guthaben | Vertrag |
| Passt für | Shops mit vielen Zielländern | Ein Hauptmarkt | Tiefe Bereinigung in einem Land |

Google steht für die erste Gruppe. Die [Abdeckungsseite](https://developers.google.com/maps/documentation/address-validation/coverage) listet im Oktober 2026 40 Länder und Regionen, darunter Deutschland, Österreich und die Schweiz; Indien und Japan sind als Vorschau markiert.

Für die dritte Gruppe ist in Deutschland die Deutsche Post Direkt das naheliegende Beispiel. Ihr Produkt ADDRESSFACTORY gleicht Privatkundenadressen mit der Postreferenz-Datenbank ab, korrigiert postalisch und liefert auf Wunsch Umzugsadressen. Die Einzelprüfung (DIRECT) dauert laut Anbieter weniger als zwei Sekunden, ein Web-Abgleich läuft innerhalb von 24 Stunden, die Variante TAPE ist für Bestände von mehr als 100.000 Adressen gedacht, und einen kostenlosen Testabgleich gibt es ab 50.000 Adressen. Solche Produkte gehen in Deutschland tiefer als eine globale Plattform. Für einen Shop, der in 30 Länder liefert, sind sie allein nicht gebaut.

## Deutsche Besonderheiten, an denen APIs scheitern

Eine globale API kennt die Grundform deutscher Adressen: Straße, Hausnummer, fünfstellige Postleitzahl, Ort. Schwieriger wird es bei den Sonderfällen, die im deutschen Versand alltäglich sind.

Packstation und Postfiliale sind der wichtigste. Statt einer Straße steht dort `Packstation 101`, dazu die Postnummer des Empfängers mit sechs bis zehn Ziffern. Eine API, die nur Hausanschriften kennt, meldet solche Adressen als nicht gefunden oder versucht, sie auf eine echte Straße umzubiegen. Teste genau das, bevor du automatische Korrekturen einschaltest.

Postfächer sind der zweite Fall. Sie haben eigene Postleitzahlen, die von der Postleitzahl der Hausanschrift abweichen. Großempfänger haben sogar eine Postleitzahl für sich allein. Wer Postleitzahl und Ort hart gegen die Straße prüft, lehnt korrekte Firmenanschriften ab.

Dazu kommt die Zeit. Laut Deutscher Post ziehen in Deutschland jeden Tag rund 22.000 Verbraucher und Unternehmen um. Eine API prüft, ob eine Adresse existiert, nicht, ob dein Kunde noch dort wohnt. Dafür gibt es Umzugsdatenbanken wie POSTADRESS MOVE, die im Beitrag zur [Umzugsdatenbank](https://address-valid.com/de/datenqualitaet/umzugsdatenbank-adressabgleich/) erklärt sind.

Hausnummernzusätze verdienen einen eigenen Testfall. `12a`, `12 A` und `12-14` sind alle gültig. Manche Prüfungen schneiden den Zusatz ab oder melden ihn als unbestätigt. Ein abgeschnittenes „a“ kann im Mehrfamilienhaus den Unterschied zwischen zwei Eingängen ausmachen.

## Was es kostet: ein Rechenbeispiel

Öffentliche Preise gibt es vor allem bei den Kartenplattformen. Google nennt für Address Validation Pro 5.000 freie Anfragen im Monat und danach 17 US-Dollar je 1.000 Anfragen in der ersten Stufe, für die Enterprise-Variante 1.000 freie Anfragen und 25 US-Dollar je 1.000. Mit steigendem Volumen sinkt der Preis.

**Beispiel: 20.000 Prüfungen im Monat mit Address Validation Pro**

- Anfragen pro Monat: 20.000
- Freikontingent: −5.000
- Abrechenbare Anfragen: 15.000
- Preis je 1.000 (erste Stufe): 17,00 $
- **Geschätzte Kosten pro Monat: 255,00 $**

Annahme: 20.000 Bestellungen, eine Prüfung pro Bestellung. Listenpreis laut Google, Oktober 2026, ohne Steuern und andere Dienste.

Zum Vergleich: UPS berechnet Geschäftskunden in Deutschland ab dem 7. Juni 2026 für eine Adresskorrektur 11,20 Euro pro Paket. Rund 23 korrigierte Pakete im Monat kosten also ungefähr so viel wie die Prüfung von 20.000 Bestellungen in diesem Beispiel, Wechselkurs außen vor. Mehr dazu im Beitrag zu den [Kosten unzustellbarer Sendungen](https://address-valid.com/de/datenqualitaet/unzustellbare-sendungen-kosten/).

Prüfe pro Bestellung einmal, nicht bei jedem Tastendruck. Vorschläge während des Tippens laufen über eine [Adress-Autovervollständigung](https://address-valid.com/de/validierung/adress-autovervollstaendigung/), die deutlich günstiger abgerechnet wird.

## Testplan mit deinen eigenen Daten

Vorführungen der Anbieter laufen mit sauberen Adressen. Deine Daten sind es nicht. Lass vor einer Entscheidung dieselbe Stichprobe durch zwei oder drei Kandidaten laufen:

**So testest du eine Adressprüfungs-API**

- [ ] 500 bis 1.000 echte Adressen aus Bestellungen ziehen, inklusive Retouren
- [ ] Alle Lieferländer abdecken, gewichtet nach Bestellmenge
- [ ] Packstation, Postfiliale, Postfach und Ortsteile einschließen
- [ ] Ergebnis je Adresse notieren: angenommen, korrigiert, unvollständig, abgelehnt
- [ ] 50 Korrekturen zufällig von Hand nachprüfen
- [ ] Antwortzeit vom eigenen Server aus messen
- [ ] Preis bei echtem Monatsvolumen plus Wachstum rechnen
- [ ] Vertrag zur Auftragsverarbeitung und Ort der Verarbeitung klären

Die Retouren sind der wertvollste Teil der Stichprobe. Bei ihnen weißt du, dass die Zustellung gescheitert ist, und siehst sofort, welcher Anbieter sie abgefangen hätte.

Achte auf Überkorrektur. Prüfmaschinen können eine Adresse auf die nächstgelegene bekannte „korrigieren“ und so aus einer neuen Adresse im Neubaugebiet eine falsche alte machen. Gute APIs melden, dass sie etwas ergänzt oder ersetzt haben. Zeig solche Änderungen dem Kunden, statt sie still zu übernehmen.

## Datenschutz gehört zur Auswahl

Jede Prüfanfrage überträgt personenbezogene Daten an einen Dienstleister. Nach der DSGVO ist das eine Auftragsverarbeitung, und du brauchst einen Vertrag nach Art. 28. Klär drei Punkte: wo die Anfragen verarbeitet werden, ob der Anbieter sie für eigene Zwecke nutzen darf und wie lange Protokolle gespeichert bleiben.

Schick nur, was die API braucht. Für die meisten Prüfungen genügen die Adresszeilen. Name, E-Mail und Bestellwert gehören nicht in die Anfrage.

## Wo die API im System sitzt

Sinnvoll ist eine Kette: Formatregeln im Browser (unser [Adressformat-Check](https://address-valid.com/de/adresse-pruefen/) zeigt sie für 15 Länder), Vorschläge beim Tippen, Prüfung per API auf dem Server bei der Bestellung und eine regelmäßige Bereinigung des Bestands. Die letzte Stufe findet, was keine Prüfung bei der Eingabe sehen kann: Umzüge und Dubletten, siehe [Adressdubletten bereinigen](https://address-valid.com/de/datenqualitaet/adressdubletten-bereinigen/).

Leg vorher fest, was bei welchem Ergebnis passiert. Vollständig bestätigt: still übernehmen. Zusatz fehlt: nachfragen. Vorschlag weicht ab: Kunde entscheidet. API nicht erreichbar: Bestellung trotzdem annehmen und später prüfen. Die Anbindung an Shop, CRM und Lager ist eher Integrationsarbeit als ein einzelner API-Aufruf; ein Datenstudio wie [OnlineBuilders](https://onlinebuilders.biz/solutions/data-analytics) übernimmt so etwas.

Dein nächster Schritt: Exportier die unzustellbaren Sendungen des letzten Quartals. Diese Datei ist dein Testdatensatz, und mit ihr weißt du nach einem Nachmittag, welcher Anbieter sein Geld wert ist.

## Häufige Fragen

### Was kostet eine Adressprüfung per API?

Das hängt von Anbieter und Menge ab. Google nennt im Oktober 2026 für Address Validation Pro 5.000 freie Anfragen im Monat und danach 17 US-Dollar je 1.000 Anfragen in der ersten Preisstufe. Anbieter mit Postdaten wie Deutsche Post Direkt arbeiten meist mit Verträgen statt öffentlicher Preisliste.

### Brauche ich für die Adressprüfung einen Vertrag zur Auftragsverarbeitung?

In aller Regel ja. Du übermittelst personenbezogene Daten an einen Dienstleister, der sie in deinem Auftrag verarbeitet. Das verlangt einen Vertrag nach Art. 28 DSGVO.

### Reicht eine API für den Checkout, oder brauche ich eine Bestandsbereinigung?

Beides hat seinen Platz. Die API prüft neue Adressen bei der Eingabe. Eine Bereinigung des Bestands findet Umzüge, Verstorbene und Dubletten, die beim ersten Speichern noch korrekt waren.

### Wie gut erkennen APIs fehlende Wohnungsangaben?

Bei US-Adressen recht zuverlässig, weil USPS-Daten Wohnungen kennen und Codes wie D für fehlende Einheit liefern. In Deutschland sind Wohnungsnummern in vielen Häusern nicht üblich, dort hilft eher ein gut sichtbares Feld für den Adresszusatz.

Foto: National Institute of Standards and Technology, Public domain (https://commons.wikimedia.org/wiki/File:RabinowJacob_042.jpg)