API Access to ASU CAS/SPS Daily space weather bulletin

Version 3.7
Released on 2023-07-06

Introduction

This product can also be used via a Web API (Application Programming Interface) for programmatically accessing the data by requesting specific URL-encoded parameters. The list of mandatory and optional variables for this specific product are included in tables 1 and 2 below:

Table 1: Mandatory parameters for API access to SPS bulletin.

Table 2: Optional parameters that can be set to refine the query.

Access to the latest data

To access the latest data, the "component" parameter in the API URL should be set to "latest" (component=latest). The URL is as follows:

https://swesnet.asu.cas.cz/prod/API/index.php?component=latest&pc=S801&psc=a
returns the latest ASU CAS bulletin in JSON format.

Access to the archived data

To access the archived data, the "component" parameter in the API URL should be set to "archive" (component=archive). The URL is as follows: https://swesnet.asu.cas.cz/prod/API/index.php?component=archive&pc=S801&psc=a
returns the last 10 days of ASU CAS data in JSON format by default.

In order to select a specific time range, the two parameters "dts_start" and "dts_end" need to be added using the format yyyy-MM-ddTHH:mm:ssZ
For example, the URL: https://swesnet.asu.cas.cz/prod/API/index.php?component=archive&pc=S801&psc=a&dts_start=2022-12-01T00:00:00Z&dts_end=2022-12-15T23:59:59Z will return of all of the available data from 01-15 December 2022.

Response and format

The returned JSON file has the following form:

[
  {
    "data": {
      "date": "datetimestamp",
      "issued": "datetimestamp",
      "observer": "name",
      "analyzed_data": "Ondrejov Observatory+various",
      "activity_level": "level",
      "sunspot_number": "number",
      "provider": "ASU CAS",
      "bulletin_solar": "TEXT"
    }
  }, REPEAT
]
    

Limitation

The archive is functional back to August 2022.