Öffentliche REST-API
Strukturierte Gemeindedaten für Entwickler, Forscher und Datenjournalisten. Kein API-Key erforderlich — rate-limitiert auf 60 Anfragen pro Minute.
Vollzugriff mit API-Key (intern): Interne API-Dokumentation →
https://www.gemeindeverzeichnis.de/apiÜbersicht
Die öffentliche API liefert amtliche Gebiets- und Strukturdaten zu Gemeinden, Kreisen und Bundesländern. Antworten sind JSON. Sensible Felder (Leitung, Kontaktdaten, interne Metadaten) sind ausgeschlossen.
Maschinenlesbare API-Beschreibung: GET /api/info
Rate Limits & API-Keys
Die API ist ohne Anmeldung nutzbar. Für höhere Kontingente gibt es kostenlose Developer-Keys — Registrierung im Dashboard.
| Plan | Anfragen/Minute | Anfragen/Tag bzw. Monat | Kosten |
|---|---|---|---|
| Ohne Key (anonym) | 60 | 500 / Tag | kostenlos |
| Developer-Key | 200 | 2.000 / Monat | kostenlos |
| Business / Pro | 1.000+ | 50.000+ / Monat, Vollabzug | auf Anfrage: info@gemeindeverzeichnis.de |
Key-Nutzung: Authorization: Bearer gvd_… — bei Überschreitung antwortet die API mit HTTP 429 und Details im JSON-Body. Max. Ergebnisse pro Listen-Request: 100.
Hinweis für Excel / Power Query
Excel führt bei jeder Aktualisierung alle Web-Abfragen erneut aus — eine Tabelle mit hunderten Zeilen à einer Abfrage pro Zeile erreicht so schnell jedes Limit. Effizienter: eine einzige Abfrage auf /api/gemeinden?bundesland=05&limit=100 (bzw. mit q=-Filter) laden und in Excel per AGS verknüpfen, statt jede Gemeinde einzeln abzufragen.
/api/gemeindenGemeindeliste / Suche
Liste oder Suche nach Gemeinden, Kreisen und Bundesländern.
Query-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| q | string | Suchbegriff (Name, optional) |
| bundesland | string | Filter nach Bundesland-AGS (2-stellig) |
| limit | number | Max. Ergebnisse (Standard 20, max. 100) |
curl "https://www.gemeindeverzeichnis.de/api/gemeinden?q=itzehoe&limit=5"/api/gemeinden/{ags}Einzeleintrag per AGS
Vollständiger öffentlicher Datensatz zu einer Verwaltungseinheit. Der AGS ist der 8-stellige Amtliche Gemeindeschlüssel.
curl "https://www.gemeindeverzeichnis.de/api/gemeinden/01061031"/api/gemeinden/by-slugLookup per SEO-Slug
Lookup über kanonische URL-Segmente (Bundesland, optional Kreis, Gemeinde).
Query-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| bundesland | string | Bundesland-Slug (Pflicht) |
| kreis | string | Kreis-Slug (optional) |
| gemeinde | string | Gemeinde-Slug (Pflicht bei Gemeinden) |
curl "https://www.gemeindeverzeichnis.de/api/gemeinden/by-slug?bundesland=schleswig-holstein&kreis=kreis-steinburg&gemeinde=itzehoe"/api/osm-id-to-agsOSM-ID → AGS
Übersetzt eine OpenStreetMap-Relation-ID in den zugehörigen AGS.
Query-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| osm_id | number | OSM-Relation-ID (Pflicht) |
curl "https://www.gemeindeverzeichnis.de/api/osm-id-to-ags?osm_id=62782"Felder
Die öffentliche API gibt nur explizit freigegebene Felder zurück. Neu für Zitierbarkeit:
| Feld | Beschreibung |
|---|---|
| ags | Amtlicher Gemeindeschlüssel (8-stellig) |
| ars | Amtlicher Regionalschlüssel |
| normalized_display_name | Anzeigename |
| population_total | Einwohnerzahl |
| population_reference_date | Stichtag der Einwohnerzahl (ISO-Datum) |
| population_source | Quelle der Einwohnerzahl (lesbar, z. B. „GV-ISys (Statistische Ämter)") |
| area_km2 | Fläche in km² |
| bundesland_slug | SEO-Slug des Bundeslands |
| kreis_slug | SEO-Slug des Kreises |
| slug | SEO-Slug der Gemeinde |
Zitierempfehlung
Bitte immer den AGS und die kanonische URL angeben. Stichtage der Einwohnerzahl stehen in population_reference_date.
Gemeindeverzeichnis.de (2026). Itzehoe (AGS 01061031). Abgerufen am 13.07.2026 von https://www.gemeindeverzeichnis.de/schleswig-holstein/kreis-steinburg/itzehoeFehlercodes
| Code | Bedeutung |
|---|---|
| 200 | Erfolg |
| 400 | Ungültige Parameter |
| 404 | Eintrag nicht gefunden |
| 429 | Rate Limit überschritten |
| 500 | Serverfehler |