Introduction

The Solcast API provides forecast, live, and historical solar irradiance, PV power, and weather data. Use it to power solar energy applications, grid management tools, and environmental monitoring systems.

Base URL

All API requests are made to the following base URL:

HTTPShttps://api.solcast.com.au

The API is only accessible over HTTPS. HTTP requests will be rejected.

OpenAPI specification

This reference is generated from the Solcast OpenAPI document. Use the live spec for tooling such as Postman, Insomnia, Swagger UI, or OpenAPI code generators — it always matches the API version currently served.

JSONhttps://api.solcast.com.au/openapi/v1/openapi.json

Requests

The API accepts parameters as URL query strings for GET requests. For POST, PUT, and PATCH requests, send parameters as a JSON body with the Content-Type: application/json header.

Content-Typeapplication/jsonRequired for requests with a body
AuthorizationBearer <API_KEY>Required for all requests
Acceptapplication/jsonRecommended

Responses

Successful responses return the requested data in the format you select — JSON, CSV, or HTML. See Response formats for how to choose a format. For failed requests, status codes, the error object, and handling guidance, see the Errors page.

Next steps

Authentication
Learn how to authenticate your API requests using Bearer tokens.
Response formats
Choose JSON, CSV, or HTML output.
Errors
Understand error response shapes and how to handle failures.

Interactive docs

Enter your API key to see which products you have access to, try endpoints live in the browser, and run requests from any endpoint page.

Quick start

Your first API request from the command line

1. Set your API key
export API_KEY="your_api_key_here"
2. Make a request
curl "https://api.solcast.com.au/data/forecast/radiation_and_weather?latitude=-33.8567&longitude=151.2152&format=json" \
  -H "Authorization: Bearer $API_KEY"
3. Read the response
{
  "forecasts": [
    {
      "air_temp": 20,
      "dni": 179,
      "ghi": 350,
      "period_end": "2026-05-16T04:00:00.0000000Z",
      "period": "PT60M"
    }
  ]
}