Video Playback

Once you've started creating recordings and transcripts, you'll likely want to display them to your users.

Video Playback

The quickest way to display videos in your application is to stream recordings directly from Recall's S3 storage using the video URLs provided by Recall's API. This eliminates the need to download, store, and re-host large video files on your own infrastructure.

Direct streaming

When you retrieve a recording using the API, the response will include a temporary download URL in the media_shortcuts.video_mixed.data.download_url field. These URLs point directly to the recorded content and can be used as video sources in your web application:

<video controls width="800" height="600">
  <source src="https://recallai-production-bot-data.s3.amazonaws.com/..." type="video/mp4">
</video>

Handling URL expiration

The S3 URLs are signed and expire after 6 hours for security reasons. Rather than caching these URLs, you should fetch fresh ones each time a user needs to access a recording:

  1. When a user requests to view a recording: Make an API call to retrieve the recording data
  2. Extract the current download_url from the media_shortcuts.video_mixed.data field
  3. Use this URL immediately as the video source in your HTML

This pattern ensures users always receive valid, non-expired URLs while keeping your application lightweight.

For a more detailed implementation, you can reference this sample application.