InfraNode.dev

Kostenlose, öffentliche Open-Data-API

Offene Stadtdaten, ein konsistenter Envelope

InfraNode bündelt fragmentierte offene Daten deutscher Großstädte hinter einer einheitlichen REST-Schnittstelle. Jede Antwort folgt demselben JSON-Envelope mit data und meta; jeder data-Record trägt zusätzlich ein attribution-Feld mit Lizenz und Herkunft, und der meta-Block nennt ehrlich den Quellen-Status, statt Dutzender unterschiedlicher Behörden- und Open-Data-APIs.

Kurz gesagt

InfraNode ist eine kostenlose, öffentliche Open-Data-REST-API, die offene Daten deutscher Großstädte hinter einer einheitlichen Schnittstelle bereitstellt. Statt dich bei Dutzenden Portalen anzumelden, fragst du alles über einen konsistenten JSON-Envelope ab, ohne API-Schlüssel.

  • 84 Großstädte, 48 Endpunkte, ein einheitlicher Envelope.
  • Kein Schlüssel nötig, kostenlos und ohne Werbung.
  • Betrieb auf einem Server in Deutschland, mit ehrlichem Quellen-Status.
  • 84 Großstädte
  • 48 Endpunkte
  • 35+ amtliche Datenquellen
  • Lizenz-Tag in jeder Antwort

Abdeckung, ehrlich erklärt

InfraNode kennt alle 84 deutschen Großstädte über 100.000 Einwohner. Davon sind 28 Kern-Städte mit voller Quellen-Abdeckung gepflegt; die übrigen Städte werden von den automatischen, AGS- und geobasierten Quellen bedient. Wo eine Quelle für eine Stadt nichts liefert, sagt die API das ehrlich über source_status, statt einen Fehler vorzutäuschen.

Was die API ausmacht

  • Kanonischer Envelope

    Jede Antwort hat dieselbe Form: data mit der Nutzlast und meta mit Stadt, Zeitstempel, source_status, correlation_id und cache_status. Jeder data-Record trägt zusätzlich ein attribution-Feld mit Lizenz und Herkunft.

  • Ehrlicher Quellen-Status

    source_status unterscheidet ok, no_data und disabled. Eine Quelle ohne Daten liefert eine saubere 200er-Antwort, keinen 5xx-Fehler.

  • Cache und ETag

    Antworten tragen ETag- und Cache-Control-Header. Bedingte Requests sparen Bandbreite und treffen den Edge-Cache.

  • MCP für KI-Agenten

    Ein MCP-Server stellt die Endpunkte als Werkzeuge für KI-Agenten bereit. Zusätzlich liegt eine llms.txt an der Wurzel für den direkten Maschinen-Konsum.

  • Echtzeitdaten unter /live

    Unter /api/v1/live/* liefert InfraNode aktuelle Messwerte: Verkehrslage, Baustellen, Parken, Laden und ÖPNV. Einige Live-Quellen sind stadtspezifisch (zum Beispiel Köln Verkehrslage, Berlin Verkehrsmeldungen). Neu ist die ÖPNV-Echtzeit mit Verspätungen je Halt, Fahrt und Linie sowie Positionsschätzung unter /api/v1/live/{stadt}/transit/departures, trips/{id} und routes/{id}/status. Die stop_id ist numerisch oder im Format de:AGS:.... Daten von gtfs.de (CC-BY-SA), refresh_seconds 45.

Einstieg

Lies den Quick-Start für den ersten Aufruf, oder springe direkt zu einem Endpunkt in der linken Navigation. Jede Operation hat Code-Beispiele in curl, JavaScript und Python sowie eine Live-Konsole für die aufrufbaren Endpunkte.

Häufige Fragen

Brauche ich einen API-Schlüssel?

Nein. Alle Endpunkte sind öffentlich lesbar, der erste Aufruf braucht keinen Schlüssel. Ein optionaler Schlüssel hebt nur das Rate-Limit auf ein höheres Tier.

Was kostet die Nutzung?

Nichts. InfraNode ist eine kostenlose, öffentliche Open-Data-API, ohne Werbung und ohne Bezahlschranke. Die Veröffentlichung des Quellcodes als Open Source ist in Vorbereitung.

Welche Städte sind abgedeckt?

Alle 84 deutschen Großstädte über 100.000 Einwohner. Davon sind 28 Kern-Städte mit voller Quellen-Abdeckung gepflegt, die übrigen werden über AGS- und geobasierte Quellen bedient.

Woher kommen die Daten?

Aus öffentlichen, amtlichen Quellen. InfraNode bündelt sie hinter einer Schnittstelle und reicht sie normalisiert durch. Jede Antwort nennt im attribution-Block Lizenz und Herkunft.

Gibt es Rate-Limits?

Ja. Anonyme Aufrufe sind IP-basiert begrenzt; ein gültiger Schlüssel im Header X-API-Key hebt das Limit. Bei Überschreitung antwortet die API mit Status 429.

Wie aktuell sind die Daten?

Das hängt von der jeweiligen Quelle ab. Antworten tragen Zeitstempel im meta-Block sowie ETag- und Cache-Control-Header. Live-Endpunkte liefern aktuelle Messwerte, statische Daten werden länger gecacht.

Durchsuchbar

Nutze die Suche oben, um Endpunkte, Parameter und Beschreibungen sofort zu finden. Die Doku wird statisch gebaut und vollständig clientseitig durchsucht, ohne Server-Roundtrip.