​
Overview

The Live Audio dataset provides access to live audio streams from regular earnings calls, capital market days, M&A announcements, and conferences – with close to zero delays. The dataset is continuously updated as new audio streams become available.

​
How it works

The API supports live streaming using the M3U8 format, a standard for HTTP Live Streaming (HLS). When a live stream request is made, the API returns an M3U8 URL. This URL can be used with any compatible media player to access the live stream. The M3U8 file acts as a playlist, referencing a series of audio segments that are updated in real time.

​
How to access the data

The API allows you to query the live Audio dataset using a variety of parameters, such as ticker, ISIN, date, and more. You can also use the API to retrieve a list of all live audio streams available in the dataset. For more information on how to use the API, see the API reference.

If you have a subscription to both the audio and transcript live datasets, you can retrieve both the Live Audio and transcript data simultaneously using the Live endpoints.

The data is served through a global CDN, ensuring low latency and high availability. The URL is unique to each Live Audio stream and customer. It should not be shared with others or altered in any way as it may result in a loss of access.

API Reference

Explore the Live Audio API endpoints.

​
Live states

A lot can happen during an event, the API provides the state property to indicate the current state of the live audio stream. The query parameter states can be used to filter events based on their state. The possible values for the property are:

  • notLive: The event is not live.

  • willBeLive: The event is scheduled to go live.

  • live: The event is currently live.

  • processingRecording: The event audio is being processed.

  • recordingAvailable: The event audio is available for playback.

You can include multiple states in the query by separating them with a comma. This is useful when you want to get both live and upcoming events.

​
Example

Below is an example of how to consume a Live Audio stream. Make sure to use the audioUrl from the API response to replace the placeholder in the code. An example is also available at CodePen.

html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Play M3U8 Audio</title>
  </head>
  <body>
    <h1>Live audio</h1>
    <audio id="audioPlayer" controls></audio>

    <!-- Include Hls.js library -->
    <script src="https://cdn.jsdelivr.net/npm/hls.js@latest"></script>
    <script>
      document.addEventListener('DOMContentLoaded', () => {
        const audioUrl = 'your-audio-stream.m3u8'; // <<< Replace
        const audio = document.getElementById('audioPlayer');

        if (Hls.isSupported()) {
          const hls = new Hls();
          hls.loadSource(audioUrl);
          hls.attachMedia(audio);
          hls.on(Hls.Events.MANIFEST_PARSED, function () {
            console.log('M3U8 manifest loaded, audio is ready to play');
          });
        } else if (audio.canPlayType('application/vnd.apple.mpegurl')) {
          audio.src = audioUrl;
          audio.addEventListener('loadedmetadata', () => {
            console.log('M3U8 audio is ready to play');
          });
        } else {
          console.error('HLS is not supported in this browser.');
        }
      });
    </script>
  </body>
</html>

Was this page helpful?