Data format for individual sites

The first row of the returned CSV file is a metadata line with information about the source. The second two rows are column headings — the first one giving the colum name, the second one its unit.

An example CSV file layout is shown below: Solar PV - Version: 1.1 - License: - Reference:,,
2016-01-01 00:00,2016-01-01 01:00,0
2016-01-01 01:00,2016-01-01 02:00,0


  • time: UTC time stamp giving the beginning of the time period (one hour by default)
  • local_time: Time stamp in the local timezone of the requested location
  • output: mean power output averaged over the time period, in kW

Corrected vs uncorrected data

Currently, data is corrected in Europe as described in: Pfenninger and Staffell 2016, Staffell and Pfenninger 2016.

When downloading data, the filename indicates whether corrections were applied.

In addition, the Corrected response header indicates whether returned data was corrected for API use.

Data format for country-aggregated data

The country-aggregated data currently looks slightly different from the individual site data – the CSV files start with two comment lines that can be ignored, one giving metadata, the other describing the units. The third line is the header line, followed by data.

Again, the time column is an UTC time stamp giving the beginning of the time period, and the remaining columns are data averaged over that time period.

An example of country-aggregated data:

"# PV (hourly data, 1985-2016) - ninja_pv_country_DE_merra-2_corrected - Version: 1.1 - License: - Reference:",
"# Units: time in UTC, other columns are capacity factors [0-1].  Bias corrected using national generation data.",
1985-01-01 00:00:00,0
1985-01-01 01:00:00,0 uses cookies to deliver its services. By continuing to use the site, you agree to this.