(Archiv) V1 API

History API

Der History-Endpunkt liefert detaillierte historische 15-Minuten-Zeitreihendaten ab 2015 bis einschließlich gestern, basierend auf Standort und Anlagenkonfiguration. Der Endpunkt unterstützt GET-Anfragen und benötigt zwingend latitude, longitude, slope, orientation sowie start_date und end_date für den gewünschten Zeitraum.

Erweiterte Daten zurück bis 2007 sind als Add-on verfügbar. Mit include_historical_data=true aktivieren und historical_data_start_year entsprechend setzen.

Ein Rate-Limit von 6 Anfragen pro Minute gilt, um Missbrauch zu verhindern. Bei Überschreitung wird 429 zurückgegeben.

Basis-URL

Code
https://api.pvnode.com/v1/history/

Beispielanfrage

Die folgenden Beispiele zeigen, wie die erforderlichen Parameter übergeben und der API-Key zur Authentifizierung genutzt wird. Das Beispiel verwendet eine Neigung (slope) von 30 Grad, eine Ausrichtung (orientation) von 180 Grad (Süden) und den Standort Rosenheim, Deutschland mit den Koordinaten latitude: 47.84812, longitude: 12.06231.

import requests

url = 'https://api.pvnode.com/v1/history/'
body = {
    "latitude": 47.84812,
    "longitude": 12.06231,
    "slope": 30,
    "orientation": 180,
    "start_date": "2023-01-01",
    "end_date": "2023-12-31"
}
headers = {
    'Authorization': 'Bearer ' + YOUR_API_KEY
}
response = requests.get(url, headers=headers, params=body)
data = response.json()

Dies ist die Basis-Konfiguration. Die API unterstützt viele weitere Parameter für Verschattung, Tracker-Systeme, Lastprofile und mehr — die vollständige Liste findet sich in der API-Referenz.

Yield API Datenspalten

History API

Basis-URL

Beispielanfrage

Erweiterte Konfiguration

Verschattung & Horizont

Tracker-Konfiguration

Lastprofile

Wettercodes

Datenspalten