If you're ready to start accessing Solcast TMY data here is what you need to know.

Step 1: Select Your Access Level

First off, you need to choose which access tier is right for you. We list these options on our pricing page and you will need to select a plan when you make your first API request from within the API Toolkit.

Which access level is best for you will generally be determined by how many TMY P50 files you will need per month. We review how you can determine your total number of requests in this article.

We offer all users access to our 'Free' tier, which includes 2x TMY API requests per month (1 request = 1 TMY file). If you need more than 2x requests per month, you'll need to upgrade to one of our paid plans. You can do this in the API Toolkit.

Step 2: Choose Your Access Method

There are two options for retrieving TMY data from the Solcast API.

Option 1: The first, and easiest option is to use the Solcast API Toolkit to make the API request.

Simply enter the location of interest to begin the process of making the API request.

It is important to make sure you select the correct file format and all of the parameters you'll want to appear in your TMY file.

You'll also have the option to specify your preferred timezone for the timestamps.

This option uses a web interface (API Toolkit) to make a request to our historical API. It will show you how many requests you have remaining on you account before you submit the current request

Option 2: The second and fastest access option is to directly connect with the Solcast historical data API.

To proceed down this route, you'll need basic API skills, including the ability to make a GET request.


The main slug of the GET request will be:

GET 'https://api.solcast.com.au/tmy_hourly?latitude=-33.856784&longitude=151.215297'

This includes the GET request, URL for the API and the location information (latitude and longitude).

The API is designed to be provided additional information, including the file format (e.g. JSON):

GET 'https://api.solcast.com.au/tmy_hourly?latitude=-33.856784&longitude=151.215297&format=json'

As well as the output parameters being requested

GET 'https://api.solcast.com.au/tmy_hourly?latitude=-33.856784&longitude=151.215297&format=json&output_parameters=air_temp,azimuth,cloud_opacity,dewpoint,ghi,dhi,dni,ebh,precip_water,relative_humidity,snow_depth,sfc_pressure,wind_direction_10m,wind_speed_10m,albedo_daily,zenith'

And then finally, you can specify the timezone, as well as additional URL parameters such as the array type, array tilt, etc.

GET 'https://api.solcast.com.au/tmy_hourly?latitude=-33.856784&longitude=151.215297&format=json&output_parameters=air_temp,azimuth,cloud_opacity,dewpoint,ghi,dhi,dni,ebh,precip_water,relative_humidity,snow_depth,sfc_pressure,wind_direction_10m,wind_speed_10m,albedo_daily,zenith&timezone=longitudinal&array_type=fixed'

If you'd like more examples, or practice building your own API request with some additional support - try out our Postman integration.

Did this answer your question?