Introduction

Next

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 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:
  • 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: 
  • 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:

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.

Note:
The Solargis Time Series and TMY data APIs operate asynchronously. This means that when you submit a data request, the API does not return the results immediately. Instead, the initial request registers your query, and you must perform a follow-up call to check the status of the calculation and retrieve your data once processing is complete. This asynchronous workflow is designed to handle potentially large and complex data queries efficiently, allowing you to track progress and download results when they are ready.

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

  • Asynchronous REST API (Solargis Time Series and TMY APIs)
  • Synchronous API (Solargis LTA and Solargis Monitor & Forecast APIs)

Format

JSON (Time Series and TMY)
XML (Monitor, Forecast, and LTA)

Authentication

API token

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
TMY - Basic, Professional
Monitor - Basic, Professional/Enterprise, Real-time
Forecast - Basic, Professional/Enterprise, Historical period, Portfolio aggregation
Long-term averages

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