StromGedacht Logo

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.

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

Ihre Anmeldung konnte nicht gespeichert werden.
Bitte versuchen Sie es erneut.
Ihre Anmeldung war erfolgreich.

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.

Mittels der API kannst du automatisiert und zwar maximal sechs Mal pro Minute den StromGedacht-Status (Grün, Gelb, 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 Standorte in der Regelzone Baden-Württemberg ausgegeben. Weitere Detailinformationen zur Nutzung der API findest du in der API-Dokumentation.

Wir benötigen deinen ungefähren Standort, um dir korrekte Daten liefern zu können. Anfragen zu Standorten außerhalb von Baden-Württemberg können wir nicht bedienen, da TransnetBW nur für die Regelzone Baden-Württemberg zuständig ist. Ferner möchten wir deinen ungefähren Standort für Analysezwecke erfahren, da uns interessiert, wo in Baden-Württemberg 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 der TransnetBW GmbH (PLZ: 70173).

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 drei kleine Programmierbeispiele in den Sprachen Python und R als Starthilfe zur Verfügung.

Wir stellen die Daten der StromGedacht-API auch im Rahmen einer B2B-API Unternehmen und Organisationen zur Verfügung, die in Baden-Württemberg ansässig sind.

Bei Interesse an einer solchen Kooperation, stellen Sie gerne eine Anfrage an stromgedacht@transnetbw.de.

Nein. Du solltest nie mehr Energie verbrauchen als du brauchst. Bei einem Überschuss an erneuerbaren Energien wird dieser genutzt, um Pumpkraftwerke aufzufüllen oder er wird anderen EU-Ländern zur Verfügung gestellt.

Du kannst deinen Verbrauch jedoch anpassen und zum Beispiel die Spülmaschine bewusst in einer supergrünen Phase laufen lassen.

Bei Abruf der StromGedacht-Programmierschnittstelle (API) wird für folgende Postleitzahlen kein Wert geliefert:
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 der 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 in ihrem 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!

PlayStore Logo

QR-Code scannen

App Store Logo

QR-Code scannen


Nutzungsbedingungen