Die StromGedacht
API
Mit unserer Programmierschnittstelle (API) ermöglichen wir dir Zugriff auf die Statusanzeige des Stromnetzes, wie sie auch in der StromGedacht-App angezeigt wird. Mithilfe der StromGedacht-API kannst du zum Beispiel Haushaltsgeräte deines Smart Homes intelligent zu den Zeiten laufen lassen, in denen sich das Stromnetz im Normalbetrieb befindet, oder in denen der Verbrauch in Vorbereitung auf eine angespannte Netzsituation vorverlegt werden soll. Während einer angespannten Netzsituation kannst du automatisiert den Verbrauch von Haushaltsgeräten reduzieren oder nicht notwendige Geräte abschalten lassen.
Die API stellt seit April 2023 Daten für das Bundesland Baden-Württemberg beriet. Im Rahmen eines gemeinsamen Pilotprojektes „Grids & Benefits“ u.a. mit TenneT und EWE Netz deckt sie ab Anfang 2025 auch Teile Niedersachsens ab (mehr Infos dazu in den FAQs unter „Für welche Postleitzahlen gibt es Daten und für welche nicht?“).
Dokumentation
So kannst du die API nutzen
Für Entwicklung und Dokumentation der StromGedacht-API haben wir das Open-Source-Tool Swagger genutzt.
Nutzungsbedinungen API
Datenschutzerklärung API
Leitfaden zur Nutzung der API
Hier erfährst du Schritt für Schritt, wie du unsere API nutzen kannst.
Zum Leitfaden
So erreichst du die API
Die StromGedacht-API sowie deren Dokumentation stehen hier für dich zur Verfügung:
api.stromgedacht.de
Updates
Erhalte Infos bei Updates der API
FAQ
Fragen und Antworten zur API
Die Nutzung der API und mittels der API bereitgestellten Daten ist kostenfrei und nur zu privaten Zwecken ohne Gewinnerzielungsabsicht gestattet. Eine Weitergabe der Daten an Dritte darf nur unter Angabe der Quelle StromGedacht, TransnetBW GmbH
erfolgen. Bei Weitergabe und/oder Nutzung der Daten würden wir uns über einen Link auf unsere Homepage (https://www.stromgedacht.de/) freuen. Bitte wende dich an stromgedacht@transnetbw.de, wenn du die API oder darüber bereitgestellte Daten zu geschäftlichen Zwecken nutzen willst. Die vollständigen Nutzungsbedingungen der API findest du hier.
Wir stellen die Daten der StromGedacht-API auch im Rahmen einer B2B-API Unternehmen und Organisationen zur Verfügung. Bei Interesse an einer solchen Kooperation, stellen Sie gerne eine Anfrage an stromgedacht@transnetbw.de.
Mittels der API kannst du automatisiert, und zwar maximal sechs Mal pro Minute, den StromGedacht-Status (Grün, Supergrün, Orange, Rot) für einen definierten Zeitraum und Standort abfragen. Bitte beachte, dass die StromGedacht-Prognosen immer nur maximal zwei Tage in die Zukunft abfragbar sind. Ferner können die StromGedacht-Daten bis maximal vier Tage in die Vergangenheit abgefragt werden. Es werden nur Daten für angegebene Postleitzahlgebiete in BadenWürttemberg (nahezu vollständig) und pilotweise in Teilen Niedersachsens ausgegeben. Weitere Detailinformationen zur Nutzung der API findest du im API-Leitfaden sowie in der API-Dokumentation.
Die API wurde mit dem gängigen Werkzeug Swagger entwickelt und dokumentiert. Wir stellen dir hier eine entsprechende Oberfläche bereit, die du zum Kennenlernen der API nutzen kannst. Daneben kannst du natürlich auch programmatisch, beispielsweise über einen entsprechenden Python-Code, auf die API zugreifen. Schaue dir dazu gerne unsere Programmierbeispiele an.
Ja, wir stellen dir in unserem Leitfaden verschiedene Programmierbeispiele als Starthilfe zur Verfügung (z.B. in den Sprachen Python und R).
Wir benötigen deinen ungefähren Standort, um dir korrekte Daten liefern zu können. Ferner möchten wir deinen ungefähren Standort für Analysezwecke erfahren, da uns interessiert, wo die StromGedacht-Daten verarbeitet werden. Die Standortangabe in Form einer Postleitzahl sollte einen hinreichenden Schutz deiner Identität gewährleisten. Solltest du trotzdem deinen Standort nicht angeben wollen, dann nutze gerne die Postleitzahl der Zentrale von TransnetBW GmbH (PLZ: 70173).
Die StromGedacht-API stellt für fast alle Postleitzahlgebiete in Baden-Württemberg Daten bereit. Die Ausnahmen bilden folgende Postleitzahlgebiete:
64754, 69434, 71332, 71336, 71364, 71397, 71404, 71409, 71522, 71540, 71546, 71549, 71554, 71560, 71563, 71566, 71570, 71573, 71576, 71696, 71711, 71717, 71720, 71723, 71726, 71729, 71737, 73663, 74199, 74206, 74211, 74223, 74232,74257, 74360, 74379, 74385, 74388, 74394, 74395.
Das liegt daran, dass die Regelzone von TransnetBW (also der Teil des Übertragungsnetzes, für den TransnetBW zuständig ist) nicht exakt mit dem Bundesland Baden-Württemberg übereinstimmt. Die aufgeführten Postleitzahlen zählen zur Regelzone des Übertragungsnetzbetreibers Amprion. TransnetBW stellt das StromGedacht-Signal nur für die Gebiete zur Verfügung, die im eigenen Verantwortungsbereich liegen.
Direkt zum Download
Hol dir jetzt die App!
Die Stromversorgung steht vor Herausforderungen – hol dir die StromGedacht-App, um jederzeit über den Status des Stromnetzes informiert zu sein und mitzuhelfen!
QR-Code scannen
QR-Code scannen