Renewables Irradiance Archive

URL Path

https://data.api.xweather.com/renewables/irradiance/archive/

Data Coverage

Europe, Africa

Update Interval

15minutes

Time Range

2004-01-19

Retrieve historical solar irradiance data for a specific location, time range, and resolution. This endpoint provides detailed information on how much solar energy reached a given point on Earth’s surface, helping you analyze solar potential, plan renewable energy projects, or validate solar forecasts.

Requests

Every request to the endpoint must include one of the supported actions in the url.

https://data.api.xweather.com/renewables/irradiance/archive/{action}?client_id={client_id}&client_secret={client_secret}&{params}

Supported Actions

The following actions are supported with the /renewables/irradiance/archive endpoint:

Action	Description
:id	Type: stringTypically used for passing a geographical location name or identifier such as city name, lat/long, or even US and Canadian postal codes. Learn more.

Response

The following is an example of what each object in the response will consist of. Depending on your requested action, the response may contain multiple instances of this object within an array.

Properties

loc (object)

The location of the record.

loc.lat (number)

The latitude coordinate of the record.

loc.long (number)

The place or nearest place to the record.

place (object)

Object containing information about the place or nearest place to the record.

place.name (string)

The place or nearest place to the record.

place.state (string)

The state abbreviation in which the response is located. This may be null or an empty string depending on the country.

place.country (string)

The 2 letter ISO-3166 country abbreviation in which the response is located.

interval (string)

The time series interval shown in ISO-8601 format

periods (array)

The archive periods.

periods.#.dateTimeISO (string)

The ISO 8601 date/time of the archive period valid time.

periods.#.tilt (object)

Tilted irradiance object

periods.#.tilt.gtiWM2 (number)

Global Tilted Irradiance – total solar power (direct + diffuse + reflected) received on a tilted surface (W/m²).

periods.#.tilt.btiWM2 (number)

Beam Tilted Irradiance – direct sunlight component on the tilted surface (W/m²).

periods.#.tilt.dtiWM2 (number)

Diffuse Tilted Irradiance – scattered sunlight reaching the tilted surface (W/m²).

periods.#.horizontal (object)

Horizontal irradiance object

periods.#.horizontal.ghiWM2 (number)

Global Horizontal Irradiance – total solar power (direct + diffuse) on a flat, horizontal surface (W/m²).

periods.#.horizontal.difWM2 (number)

Diffuse Horizontal Irradiance – scattered sunlight on a horizontal surface (W/m²).

periods.#.horizontal.dniWM2 (number)

Direct Normal Irradiance – direct sunlight power on a surface perpendicular to the sun’s rays (W/m²).

periods.#.reflectedWM2 (number)

Solar power reflected from the ground or surroundings to the tilted surface (W/m²).

periods.#.clearSkyWM2 (number)

Theoretical irradiance under cloudless (clear sky) conditions on the tilted surface (W/m²).

periods.#.topOfAtmosphereWM2 (number)

Solar irradiance at the top of Earth’s atmosphere before atmospheric attenuation (W/m²).

profile (object)

Object containing information about the location or event.

profile.tz (string)

Timezone name of the location, such as America/New_York.

profile.elevM (number)

The elevation of the location in meters.

profile.elevFT (number)

The elevation of the location in feet.

profile.tiltAngle (number)

Tilt angle being used to calculate irradiance. Null if unavailable.

profile.horizonShadow (number)

Horizon shadow being used to calculate the irradiance. Null if unavailable.

profile.azimuthAngle (number)

Azimuth angle used to calculate the irradiance. Null if unavailable.

{
  "loc": {
    "lat": 40,
    "long": 44
  },
  "place": {
    "name": "kuzuguden",
    "state": "ig",
    "country": "tr"
  },
  "interval": "PT60M",
  "periods": [
    {
      "dateTimeISO": "2005-06-27T22:00:00.000",
      "tilt": {
        "gtiWM2": 0,
        "btiWM2": 0,
        "dtiWM2": 0
      },
      "horizontal": {
        "ghiWM2": 0,
        "difWM2": 0,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 0,
      "topOfAtmosphereWM2": 0
    },
    {
      "dateTimeISO": "2005-06-27T23:00:00.000",
      "tilt": {
        "gtiWM2": 0,
        "btiWM2": 0,
        "dtiWM2": 0
      },
      "horizontal": {
        "ghiWM2": 0,
        "difWM2": 0,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 0,
      "topOfAtmosphereWM2": 0
    },
    {
      "dateTimeISO": "2005-06-28T00:00:00.000",
      "tilt": {
        "gtiWM2": 0,
        "btiWM2": 0,
        "dtiWM2": 0
      },
      "horizontal": {
        "ghiWM2": 0,
        "difWM2": 0,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 0,
      "topOfAtmosphereWM2": 0
    },
    {
      "dateTimeISO": "2005-06-28T01:00:00.000",
      "tilt": {
        "gtiWM2": 0,
        "btiWM2": 0,
        "dtiWM2": 0
      },
      "horizontal": {
        "ghiWM2": 0,
        "difWM2": 0,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 0,
      "topOfAtmosphereWM2": 0
    },
    {
      "dateTimeISO": "2005-06-28T02:00:00.000",
      "tilt": {
        "gtiWM2": 5.3176,
        "btiWM2": 0,
        "dtiWM2": 5.3176
      },
      "horizontal": {
        "ghiWM2": 5.61,
        "difWM2": 5.61,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 2.8873,
      "topOfAtmosphereWM2": 9.6964
    },
    {
      "dateTimeISO": "2005-06-28T03:00:00.000",
      "tilt": {
        "gtiWM2": 107.2171,
        "btiWM2": 54.6864,
        "dtiWM2": 52.5307
      },
      "horizontal": {
        "ghiWM2": 106.9287,
        "difWM2": 52.7664,
        "dniWM2": 346.5167
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 97.5784,
      "topOfAtmosphereWM2": 185.3922
    },
    {
      "dateTimeISO": "2005-06-28T04:00:00.000",
      "tilt": {
        "gtiWM2": 292.6839,
        "btiWM2": 212.4653,
        "dtiWM2": 80.2186
      },
      "horizontal": {
        "ghiWM2": 291.7122,
        "difWM2": 80.2186,
        "dniWM2": 640.1076
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 285.5202,
      "topOfAtmosphereWM2": 426.5234
    },
    {
      "dateTimeISO": "2005-06-28T05:00:00.000",
      "tilt": {
        "gtiWM2": 492.7937,
        "btiWM2": 398.5619,
        "dtiWM2": 94.2318
      },
      "horizontal": {
        "ghiWM2": 491.6671,
        "difWM2": 94.2318,
        "dniWM2": 789.4372
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 488.0883,
      "topOfAtmosphereWM2": 661.4061
    },
    {
      "dateTimeISO": "2005-06-28T06:00:00.000",
      "tilt": {
        "gtiWM2": 682.9082,
        "btiWM2": 568.6033,
        "dtiWM2": 114.3049
      },
      "horizontal": {
        "ghiWM2": 681.8499,
        "difWM2": 114.3049,
        "dniWM2": 854.5866
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 677.1495,
      "topOfAtmosphereWM2": 874.0343
    },
    {
      "dateTimeISO": "2005-06-28T07:00:00.000",
      "tilt": {
        "gtiWM2": 844.5841,
        "btiWM2": 705.4447,
        "dtiWM2": 139.1394
      },
      "horizontal": {
        "ghiWM2": 843.7306,
        "difWM2": 139.1394,
        "dniWM2": 883.9121
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 834.8857,
      "topOfAtmosphereWM2": 1049.9167
    },
    {
      "dateTimeISO": "2005-06-28T08:00:00.000",
      "tilt": {
        "gtiWM2": 952.9023,
        "btiWM2": 795.7654,
        "dtiWM2": 157.1369
      },
      "horizontal": {
        "ghiWM2": 952.3448,
        "difWM2": 157.1369,
        "dniWM2": 889.959
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 948.7922,
      "topOfAtmosphereWM2": 1177.0646
    },
    {
      "dateTimeISO": "2005-06-28T09:00:00.000",
      "tilt": {
        "gtiWM2": 1007.8378,
        "btiWM2": 841.5805,
        "dtiWM2": 166.2574
      },
      "horizontal": {
        "ghiWM2": 1007.6203,
        "difWM2": 166.2574,
        "dniWM2": 889.0018
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 1010.7882,
      "topOfAtmosphereWM2": 1246.8093
    },
    {
      "dateTimeISO": "2005-06-28T10:00:00.000",
      "tilt": {
        "gtiWM2": 1011.2737,
        "btiWM2": 844.391,
        "dtiWM2": 166.8827
      },
      "horizontal": {
        "ghiWM2": 1011.4105,
        "difWM2": 166.8827,
        "dniWM2": 886.9339
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 1017.0713,
      "topOfAtmosphereWM2": 1254.3944
    },
    {
      "dateTimeISO": "2005-06-28T11:00:00.000",
      "tilt": {
        "gtiWM2": 963.0038,
        "btiWM2": 804.0447,
        "dtiWM2": 158.9591
      },
      "horizontal": {
        "ghiWM2": 963.4834,
        "difWM2": 158.9591,
        "dniWM2": 883.6937
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 967.1265,
      "topOfAtmosphereWM2": 1199.2991
    },
    {
      "dateTimeISO": "2005-06-28T12:00:00.000",
      "tilt": {
        "gtiWM2": 858.453,
        "btiWM2": 716.6905,
        "dtiWM2": 141.7625
      },
      "horizontal": {
        "ghiWM2": 859.2314,
        "difWM2": 141.7625,
        "dniWM2": 870.693
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 863.7947,
      "topOfAtmosphereWM2": 1085.2749
    },
    {
      "dateTimeISO": "2005-06-28T13:00:00.000",
      "tilt": {
        "gtiWM2": 720.0619,
        "btiWM2": 600.325,
        "dtiWM2": 119.7368
      },
      "horizontal": {
        "ghiWM2": 721.0815,
        "difWM2": 119.7368,
        "dniWM2": 860.5944
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 714.9548,
      "topOfAtmosphereWM2": 920.0894
    },
    {
      "dateTimeISO": "2005-06-28T14:00:00.000",
      "tilt": {
        "gtiWM2": 537.6668,
        "btiWM2": 438.8378,
        "dtiWM2": 98.829
      },
      "horizontal": {
        "ghiWM2": 538.7933,
        "difWM2": 98.829,
        "dniWM2": 808.1684
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 532.2436,
      "topOfAtmosphereWM2": 714.9965
    },
    {
      "dateTimeISO": "2005-06-28T15:00:00.000",
      "tilt": {
        "gtiWM2": 333.9404,
        "btiWM2": 246.4649,
        "dtiWM2": 87.4755
      },
      "horizontal": {
        "ghiWM2": 334.9434,
        "difWM2": 87.4755,
        "dniWM2": 664.6407
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 331.6095,
      "topOfAtmosphereWM2": 483.9688
    },
    {
      "dateTimeISO": "2005-06-28T16:00:00.000",
      "tilt": {
        "gtiWM2": 139.1587,
        "btiWM2": 70.8626,
        "dtiWM2": 68.296
      },
      "horizontal": {
        "ghiWM2": 139.7031,
        "difWM2": 68.296,
        "dniWM2": 356.6741
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 136.9814,
      "topOfAtmosphereWM2": 242.7453
    },
    {
      "dateTimeISO": "2005-06-28T17:00:00.000",
      "tilt": {
        "gtiWM2": 15.7733,
        "btiWM2": 3.1935,
        "dtiWM2": 12.5798
      },
      "horizontal": {
        "ghiWM2": 16.4058,
        "difWM2": 13.1459,
        "dniWM2": 44.7304
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 11.6222,
      "topOfAtmosphereWM2": 32.3072
    },
    {
      "dateTimeISO": "2005-06-28T18:00:00.000",
      "tilt": {
        "gtiWM2": 0,
        "btiWM2": 0,
        "dtiWM2": 0
      },
      "horizontal": {
        "ghiWM2": 0,
        "difWM2": 0,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 0,
      "topOfAtmosphereWM2": 0
    },
    {
      "dateTimeISO": "2005-06-28T19:00:00.000",
      "tilt": {
        "gtiWM2": 0,
        "btiWM2": 0,
        "dtiWM2": 0
      },
      "horizontal": {
        "ghiWM2": 0,
        "difWM2": 0,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 0,
      "topOfAtmosphereWM2": 0
    },
    {
      "dateTimeISO": "2005-06-28T20:00:00.000",
      "tilt": {
        "gtiWM2": 0,
        "btiWM2": 0,
        "dtiWM2": 0
      },
      "horizontal": {
        "ghiWM2": 0,
        "difWM2": 0,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 0,
      "topOfAtmosphereWM2": 0
    },
    {
      "dateTimeISO": "2005-06-28T21:00:00.000",
      "tilt": {
        "gtiWM2": 0,
        "btiWM2": 0,
        "dtiWM2": 0
      },
      "horizontal": {
        "ghiWM2": 0,
        "difWM2": 0,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 0,
      "topOfAtmosphereWM2": 0
    },
    {
      "dateTimeISO": "2005-06-28T22:00:00.000",
      "tilt": {
        "gtiWM2": 0,
        "btiWM2": 0,
        "dtiWM2": 0
      },
      "horizontal": {
        "ghiWM2": 0,
        "difWM2": 0,
        "dniWM2": 0
      },
      "reflectedWM2": 0,
      "clearSkyWM2": 0,
      "topOfAtmosphereWM2": 0
    }
  ],
  "profile": {
    "tz": "Europe/Istanbul",
    "elevM": 872,
    "elevFT": 2861,
    "tiltAngle": null,
    "horizonShadow": null,
    "azimuthAngle": null
  }
}

Endpoints