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. You can learn more about the related Solargis Monitor and Solargis Forecast services in our knowledge base.
- 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. The technical guide is explained here.
- 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. Details about both datasets, available plans, and their specifications are provided in our knowledge base.
- Subscription details API endpoint - use this endpoint to download information about your subscription and usage history.
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, XML |
Authentication | API token (generated in Solargis account administration) |
Endpoints | Separate endpoints for: |
Output Parameters | Solar: GHI, DNI, DIF, GTI, SUN_ELEVATION, etc. (varies by plan) |
Time Resolution | TMY - 15-minute, hourly (depending on subscription plan) |
Geographic Coverage | Global (excluding polar regions) |
Historical Data | Available from 1994 to present, depending on the region |
Subscription Plans | 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 |