Welcome to Forecast.Solar
Restful API for Solar production forecast data and Weather forecast data.
powered among others by PVGIS, Dark Sky, Wunderground and OpenWeatherMap
Actual serving locations with planes with MWp.
Served requests with a harmonic mean of ms in the last 24 hours.
Features
Forecast.Solar provides data based on your location, the declination and orientation of your solar panels.
Solar production
(All plans)
The always weather based solar production forecast, historic averages and clear sky optimum provides watt powers and kilo watt energy data.Weather
(Professional account)
The weather forecast provide sky coverage amount, textual weather condition and icon URL, temperature and some wind information.Chart
(Professional account)
Draw a daily solar production forecast chart with simple Javascript snippets.Solar production forecast and weather forecast data are provided for up to 7 days with a resolution of 1 hour down to 15 minutes.
If you then checked the documentation and you like it, register an account for more features.
Data coverage
The figure shows the areas covered by the Photovoltaic Geographical Information System (PVGIS) solar radiation databases and therefor by Forecast.Solar.
(Click to enlarge)
Restful API
Example: Get solar production estimate
Request
https://forecast.solar/_your_API_key_/estimate/54.9/25.3/37/0/1Response (professional account, 15 minutes resolution)
{
"result": {
"watts": {
"2019-06-22 05:15:00": 17,
"2019-06-22 05:30:00": 22,
"2019-06-22 05:45:00": 27,
...
"2019-06-29 20:15:00": 14,
"2019-06-29 20:30:00": 11,
"2019-06-29 20:45:00": 7
},
"watt_hours": {
"2019-06-22 05:15:00": 0,
"2019-06-22 05:30:00": 6,
"2019-06-22 05:45:00": 12,
...
"2019-06-29 20:15:00": 2545,
"2019-06-29 20:30:00": 2548,
"2019-06-29 20:45:00": 2550
},
"watt_hours_day": {
"2019-06-22": 2626,
"2019-06-23": 2918,
"2019-06-24": 2526,
"2019-06-25": 2866,
"2019-06-26": 2892,
"2019-06-27": 1900,
"2019-06-28": 2199,
"2019-06-29": 2550
}
},
"message": {
"type": "success",
"code": 0,
"text": ""
}
}Chart
You can direct draw chart for solar production estimate using the Forecast.Solar widget.
(Professional account)Chart for the geographical midpoint of Germany at 51°9'N,10°27'E with a declination of 37°, looking south with 10 kilo watt peak installated.
Today
/chart/0/1442fd2d.jsWithout given title or subtitle, no title is printed and the subtitle defaults to date
Tomorrow
/chart/1/1442fd2d.js?title=Forecast+for+{date}Title with date placeholder, no subtitle is printed
Todays historic average production
/chart/history/1442fd2d.js?title=Historic+dataTitle without date placeholder, subtitle defaults in this case to the date
Todays theoretical clear sky production
/chart/clearsky/1442fd2d.js?subtitle={place}No title given but subtitle with placeholder
Account models
As pre-check you can test with the Photovoltaic Geographical Information System (PVGIS).
Public
Free
No registration required, free for life.
- Solar production forecast data
- Forecast horizon: This and the next day
- Data resolution: 1 hour
If you don't want to use your paid subscription after the trial period, you can cancel the subscription any time during the trial period and no costs will be charged.
Personal
12 EUR/year
(equate to 1 EUR/month)Registration with a valid email required, access with API key, free trial of 14 days.
Provide the same features as the Public API plus:
- Average historic solar production data
- Forecast horizon: This and the next 3 days
- Data resolution: 30 minutes
Personal Plus
24 EUR/year
(equate to 2 EUR/month)Registration with a valid email required, access with API key, free trial of 14 days.
Provide the same features as the Personal API with more detailed data:
- Forecast horizon: This and the next 3 days
- Data resolution: 15 minutes
Professional
60 EUR/year
(equate to 5 EUR/month)Registration with a valid email required, access with API key, free trial of 14 days.
Provide the same features as the Personal API plus:
- Request up to 3 planes in one request
- Solar production forecast chart
- Weather forecast data
- Theoretical solar production data under clear sky conditions
- Forecast horizon: This and the next 6 days
- Data resolution: 15 minutes
It is not allowed to share the API key with e.g. clients of your product! (It will also not work because of the rate limits for the API key.)
If you are developing an APP that will be used by clients, the following setup is suggested:
- Deliver the APP with the use of the Public API.
- Give the clients the option to subscribe for an own API key if they are interested in having data more accurate.
(This for example the way, how the Home Assistant integration works.)
If you will not share the API key and you can guarantee, that your API key is not viewable to others, please get in touch for an Enterprise account.
Enterprise
Registration with a valid email required, access with API key, free trial of 14 days.
Provide the same features as the Professional API, but with higher rate limits.
If you use the Home Assistant project, there is a integration available.
The integration was introduced in Home Assistant 2021.7
Support channels
With the increasing share of photovoltaics in the electricity market, the importance of Solar energy forecasts. These are an important tool for the integration of Solar power into existing network structures.
The production of solar power is dependent on external influences on which man has no or only limited influence. For example, Season, time of day, weather (eg ambient temperature, clouds, air turbidity).
A solar day covers the global energy supply for eight years.
Predictions about the availability of solar-generated electricity in the future support private power management, but are of great importance, above all, for commercial solar power generators and network operators.
