(Archive) V1 API

Historical Data

The History endpoint provides detailed historic 15-minute time-series data from 2015 up to yesterday for photovoltaic (PV) systems based on their site's location and installation characteristics. This endpoint supports GET requests that require latitude, longitude, slope, orientation, as well as a start_date and end_date for the requested time range.

Extended data going back to 2007 is available as an add-on. Pass include_historical_data=true and set historical_data_start_year accordingly.

A rate limit of 6 requests per minute applies to prevent abuse. Exceeding this will return a 429 response.

Base URL

The Base URL for this endpoint is:

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

Example Request

The following examples demonstrate how to pass the required parameters and include the API key for authentication. The example uses a slope of 30 degrees, an orientation of 180 degrees (south-facing), and the location is set to Rosenheim, Germany with coordinates 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()

This covers the base configuration. The API supports many additional parameters for shading, tracker systems, demand profiles, and more — see the API Reference for the full list.

Yield API Data Columns

Historical Data

Base URL

Example Request

Advanced Configuration

Shading & Horizon

Tracker Configuration

Demand Profiles

Weather Codes

Data Columns