How to access a stream's metadata via API

Aiir Streaming customers sometimes need to pull now playing metadata from their stream to integrate with other applications.

This can be done using our streaming API.

Using a parser to read from the API

An application programming interface (API) is a set of rules and protocols that allow multiple systems to exchange information.

Aiir Streaming uses a simple URL to allow other applications to use its metadata:

https://streaming-api.aiir.com/mounts/metadata/history/[mountpoint]?limit=[items]

Replace [mountpoint] with your station's mount point (the 13 letters or numbers contained in your stream URL) and [items] with the number of recently played items you want to return. You should not include the square brackets.

If you open this URL in a browser, you will see the recent items played on your stream, along with the number of people listening at the time. For example:

 {
    "title": "SOS - ABBA",
    "listeners": 110,
    "timestamp": 1750411697171
 },

The timestamp returned is in the standard Unix format (milliseconds since the Unix epoch - January 1, 1970, 00:00:00 UTC). Other applications can use this to convert the time the item was played into its preferred format.

In the example above, the timestamp would convert to 1:28 AM on Friday 19 July 2025, and could be rendered down to the nearest millisecond if required.