Introduction

  • Updated on May 26, 2025
  • Published on May 21, 2025
  • 2 minute(s) read
  • MK
 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. 

  • Monitor & Forecast API endpoint - lets you download 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 Monitor and Forecast services in our knowledge base.
  • Long-term averages API endpoint - similar to the Monitor & Forecast endpoint. Uses XML for communication and lets you download Long-term averages (LTA) data using the synchronous method. 
  • Time Series and TMY data API endpoints - separate product, dedicated to downloading Solargis Time Series and TMY data asynchronously. This method is 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.

Time Series and TMY data API endpoints

You can use Time Series and TMY data 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 TS API can be found on our GitHub.

Technical specification

Field

Value / Description

Type

Asynchronous REST API

Format

JSON

Authentication

API token (generated in Solargis account administration)

Endpoints

Separate endpoints for Time Series (TS) and Typical Meteorological Year (TMY) data

Output Parameters

Solar: GHI, DNI, DIF, GTI, SUN_ELEVATION, etc. (varies by plan)

Time Resolution

TMY - 15-minute, hourly (depending on subscription plan)
TS - 15-minute, hourly, daily, monthly, yearly (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
TMY - Basic, Professional
(defines available parameters, resolution, and usage limits)

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