API reference/Energy & Utilities/Solar PV Yield Estimate (PVGIS)

Solar PV Yield Estimate (PVGIS)

free European Union Any country

Expected yearly and monthly output of a grid-connected solar PV system at any land location in Europe, Africa, most of Asia and the Americas: kWh per year and month, specific yield, irradiation, losses, and the optimal tilt and azimuth when you do not give them.

GET/api/v1/energy/solar-yield

Data source

Query parameters

ParameterDescriptionTry value
lat
number required
Latitude
lon
number required
Longitude
peakKw
number
Installed peak power in kW (default 1)
lossPct
number
System losses in % (default 14)
tilt
number
Panel tilt in degrees, 0 = flat (default optimal)
azimuth
number
Panel azimuth, 0 = south, 90 = west, -90 = east (default optimal)
mounting
string
free (free-standing, default) or building (integrated)
apikey
string required
Your API key. Can also be sent as the X-API-Key header.demo key used here

Response envelope

Success: { data, meta: { sources, fetchedAt, cached } }. Errors: { error: { code, message } } with HTTP 400, 401, 404, 502, 503 or 504.