Rooftop Rooftop Solar Forecasts

API Documentation for our Rooftop Solar Forecasting product

Rooftop Sites

Creation of rooftop sites (see docs here) allows you to POST your power measurements and take advantage of our tuning feature. This is typically the best approach when you have a small to medium number (say ~< 100) of pre-known, fixed sites where accuracy is of prime importance. You can also add a test rooftop site using your web browser using the Solcast API Toolkit.

Simple Lat/Lon PV Power Requests

What is the Simple PV Power Request?

The Simple PV Power request returns a first-guess PV power output forecast, based on your specified latitude and longitude plus some basic PV system characteristics. This request doesn’t allow for tuning and other site management tools, but it is great for large numbers of sites, and where sites need to be easily added or changed instantly. You can test this request under your Free plan, and if you need to scale it up you can contact us to get bulk pricing options under an Enterprise plan - see pricing and plans for details.

The past 7 days of estimated actuals for PV power output is also available. All of the data are generated using our Rapid Update forecasting systems, and offer Global Coverage.

What data is provided by the API?

The data in each row are 30-minute period end averages and are in UTC. The data are updated every 5-15 minutes

More details can be found in our PV Power API Documentation and OpenAPI definition.

Property Required Description
capacity Yes The capacity of the system, units in kilowatts. Must be greater than zero.
tilt No The angle (degrees) that the PV system is tilted off the horizontal. Must be between 0 and 90. A tilt of 0 means the system is facing directly upwards, and 90 means the system is vertical and facing the horizon. The default value is 23.
azimuth No The angle (degrees) from true north that the PV system is facing, if titled. Must be between -180 and 180. An azimuth of 0 means the system is facing true north. Positive values are anticlockwise, so azimuth is -90 for an east-facing system and 135 for a southwest-facing system. The default value is 0 (north facing) in the southern hemisphere, 180 (south-facing) in the northern hemisphere.
install_date No The date (yyyy-MM-dd) of installation of the PV system. We use this to estimate your loss_factor based on the ageing of your system. If you provide us with a loss_factor directly, we will ignore this date.
loss_factor No A factor by which to reduce your output forecast from the full capacity based on characteristics of the PV array or inverter. This is effectively the non-temperature loss effects on the nameplate rating of the PV system, including inefficiency and soiling. For a 1kW PV system anything that reduces 1000W/m2 solar radiation from producing 1000W of power output (assuming temperature is 25C)

GET Request (Forecast)

Please note you’ll need to place your API Key in the below GET request at YOUR_API_KEY.

GET https://api.solcast.com.au/world_pv_power/forecasts?longitude=149.117&latitude=-35.277&capacity=1000&format=json&api_key=YOUR_API_KEY

GET Request Return (Forecast)

{
  "forecasts": [{
      "period_end": "2017-01-30T04:00:00.0000000Z",
      "period": "PT30M",
      "pv_estimate": 420.767208900235
    }, {
      "period_end": "2017-01-30T04:30:00.0000000Z",
      "period": "PT30M",
      "pv_estimate": 311.890641831329
    }
  ]
}

GET Request (Estimated Actuals)

Please note you’ll need to place your API Key in the below GET request at YOUR_API_KEY.

GET https://api.solcast.com.au/world_pv_power/estimated_actuals?longitude=149.117&latitude=-35.277&capacity=1000&format=json&api_key=YOUR_API_KEY

GET Request Return (Estimated Actuals)

{
  "estimated_actuals": [{
      "period_end": "2017-01-29T22:00:00.0000000Z",
      "period": "PT30M",
      "pv_estimate": 723.640155693826
    }, {
      "period_end": "2017-01-29T21:30:00.0000000Z",
      "period": "PT30M",
      "pv_estimate": 618.347032902544
    }
  ]
}