Live Calls

The Quartr API allows streaming of event audio as its currently being broadcasted. The currently-live endpoint allows access to event data of all currently ongoing events.

The most basic request to this endpoint using curl or javascript with a user: ‘demo’ and password: ‘p@55w0rd’ can be made like this.

curl --location --request GET 'https://api.quartr.com/public/v1/live/currently-live' \--header 'Authorization: Basic ZGVtbzpwQDU1dzByZA=='

const username = 'username'; // replace with your username
const password = 'password'; // replace with your password

axios.get(`https://api.quartr.com/public/v1/live/currently-live`, { 
    auth: { username, password }, 
})
.then(response => {
    console.log(response.data);
})
.catch(error => console.log(error));

With this example response you can notice the difference from earlier held events, where the audio resource is available as an mp3 from the URL in the audioUrl field, that the streamable object in the form of a m3u8 playlist is instead located in the liveState object. This can be streamed using an hls service, for example hls.js in a node-environment.

{
    "data": [
        {
            "audioUrl": null,
            "audioDuration": null,
            "reportUrl": null,
            "pdfUrl": null,
            "eventId": 50839,
            "companyId": 11630,
            "eventTitle": "Investor Day 2023",
            "eventDate": "2023-02-16T14:00:00.000Z",
            "qnaTimestamp": null,
            "fiscalPeriod": null,
            "fiscalYear": "2023",
            "eventType": {
                "type": "Investor Day",
                "secondaryType": null
            },
            "liveState": {
                "liveAudioState": "live",
                "liveUrl": "https://quartr-streams.s3.eu-north-1.amazonaws.com/streams/2023-02-16/09663f28-de8a-4f4a-89cc-6eae17974c04/playlists.m3u8",
                "wentLiveAt": "2023-02-16T14:03:09.000Z"
            }
        }
    ],
    "pagination": {
        "total": 1,
        "page": 1,
        "totalPages": 1,
        "limit": 10
    }
}

The following example yields a basic player to stream a live event using the third party package hls.js.

<!DOCTYPE html>
<html>
<head>
  <title>Quartr Live Audio Stream Example</title>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <script src="https://cdn.jsdelivr.net/npm/hls.js@0.14.0/dist/hls.min.js"></script>
</head>
<body>
  <audio id="player" controls></audio>
  <script>
    const username = 'username'; // replace with your username
    const password = 'password'; // replace with your password
    const url = 'https://api.quartr.com/public/v1/live/currently-live';
    const player = document.getElementById('player');
    const hls = new Hls();
    const fetchLiveAudioStream = async () => {
      try {
        const response = await fetch(url, {
          headers: {
            Authorization: 'Basic ' + btoa(username + ':' + password)
          }
        });
        const data = await response.json();
        const liveState = data.data[0].liveState;
        if (liveState && liveState.liveAudioState === 'live') {
          const audioUrl = liveState.liveUrl;
          hls.loadSource(audioUrl);
          hls.attachMedia(player);
          hls.on(Hls.Events.MANIFEST_PARSED, () => {
            player.play();
          });
        }
      } catch (error) {
        console.error(error);
      }
    };
    fetchLiveAudioStream();
  </script>
</body>
</html>