Solargis API documentation
Solargis API is designed for solar project developers, analysts, consultants, and system integrators who require precise solar and meteorological data for a variety of applications.
Our platform offers several API endpoints and data download methods, accommodating various scenarios.
- Solargis Monitor & Forecast API endpoint- lets you download Solargis Time Series data using the synchronous method, suitable for monitoring and forecasting applications. This API uses XML format for communication. Links to related documentation:
- Solargis Monitor and Solargis Forecast service introductions
- Technical guide
- Solargis Long-term averages API endpoint - similar to the Solargis Monitor & Forecast endpoint. Uses XML for communication and lets you download Long-term averages (LTA) data using the synchronous method. It is part of our Solargis Prospectsolution. Links to related documentation:
- Long-term average service introduction
- Technical guide
- Solargis Time Series and TMY API endpoints - separate product, dedicated to downloading Solargis Time Series and TMY data asynchronously. The TMY data is also suitable for usage in 3rd-party applications such as PVsyst. Both are part of the Solargis Evaluate solution. Links to related documentation:
- Time series and TMY service introduction
- Time Series integration guide
- Time series technical guide
- TMY integration guide
- TMY technical guide
- Subscription details API endpoint - use this endpoint to download information about your subscription and usage history. The technical guide can be found here.
Note: TMY and Time series endpoints can be accessed directly in the API documentation using the provided API console. You can learn how to work with it here.
Time Series and TMY data API endpoints
You can use Time Series and TMY API endpoints to download Time Series (TS) and Typical Meteorological Year (TMY) data for specific locations. Each data type has a dedicated API endpoint, and access is secured using an API authentication token. The types of data you can access and the level of detail (granularity) depend on your API subscription plan.
To get started with these APIs, you need to:
- Have a Solargis account with an active API subscription.
- Obtain an API authentication token - required for every API request call.
When setting up your integration for the first time, take advantage of our free integration setup endpoints, which you can use for test calls while building your integration. The initial integration setup guide is provided within each section in the respective integration setup document.
You can purchase an API subscription by contacting us directly or reaching out to your account manager. Once your subscription is active, you can generate authentication tokens in the account administration section. Details about available subscription plans and the specific data included with each plan are provided here.
A Python code example on how to integrate the async Time Series API can be found on our GitHub.
Technical specification
Field | Value / Description |
---|---|
Type |
|
Format | JSON (Time Series and TMY) |
Authentication | |
Endpoints | Separate endpoints for: |
Time Resolution | 15-minute, hourly, daily, monthly, yearly (depending on subscription plan) |
Geographic Coverage | Global (excluding polar regions) |
Historical data | Available from 1994 to the present, depending on the region |
Subscription plans and parameters | Time Series - Professional, Enterprise |
Rate Limits | Defined by subscription; usage tracked via custom HTTP headers |
Supported Use Cases | Feasibility analysis, site assessment, PV system design, performance benchmarking, forecasting |
Integration | Designed for automated integration with PV simulation and monitoring platforms |
Error Handling | Standard HTTP status codes and error messages |