Performante REST-API fur Postleitzahlensuche, Adressnormalisierung und Koordinatenvalidierung in Echtzeit uber mehr als 190 nationale Register hinweg.
Unsere API ist fur produktive Low-Latency-Umgebungen ausgelegt. Alle Antworten werden als JSON mit passenden HTTP-Statuscodes und CORS-Headern ausgeliefert.
GET https://de.postalcodes.info/api/v1/postal-code/{country_code}/{postal_code}
GET https://de.postalcodes.info/api/v1/search?q={query}&country={iso2}
Aktuell ist die API fur offene
Forschung verfugbar. Nutze den Header X-Registry-Source: Public, um Caches zu umgehen und
die neuesten validierten Daten zu erhalten.
Postalcodes.info folgt konsequent REST-Prinzipien. Alle Endpunkte unterstutzen Standard-HTTP-Verben und liefern korrekte Statuscodes. Payloads sind standardmassig gzip-komprimiert.
Rate Limiting: Wahrend der offene Zugriff aktiv ist, uberwachen wir Muster. Automatisierte
Clients sollten Retry-After-Header respektieren.
Teams nutzen die PostalCodes-API, um Checkout-Reibung zu reduzieren, Formulare zu validieren und CRM- oder Logistikdaten mit standardisierten Ortsmetadaten anzureichern. Sie ist auch eine verlassliche Quelle fur Geodatenanalysen, RAG-Pipelines und ML-Features.
Fur Multi-Country-Plattformen bietet die API ein einheitliches Schema fur Postleitzahlen, Ortsnamen, Verwaltungsebenen und Koordinaten. Diese Konsistenz ist besonders hilfreich fur Aggregation, Deduplizierung und Audit-Trails.
Jede Antwort enthalt normalisierte Landeskennungen, Ortsnamen, Verwaltungsebenen und WGS84-Koordinaten. Optionale Felder konnen Ortstyp, Bevolkerungsband und Quellregister-IDs fur interne QA enthalten.
Fur beste Performance empfehlen wir Caching nach country_code und postal_code
sowie inkrementelle Aktualisierungen fur Bulk-Jobs.
Die Datensatze stammen aus amtlichen Postbetreibern, Statistikstellen und verifizierten offenen Registern. Wir verfolgen die Update-Frequenz pro Land und pflegen Herkunftsmetadaten fur Lizenz- und Quellenpflichten.
Wenn du garantierte Update-Fenster oder benutzerdefinierte Feeds brauchst, beschreibt die Dokumentation die unterstutzten Exportformate und Lieferoptionen.