List Live Streams
Sometimes you will want a complete list of all your live stream containers. Sometimes you will want a list to choose a specific live stream container. This guide walks you through how to retrieve this information.
Choose an api.video client
The clients offered by api.video include:
To install your selected client, do the following:
Create an account
Before you can start streaming, you need to create an api.video account.
Once you are logged in to the Dashboard, select the environment of your choice (sandbox or production) and copy your API key.
List all live streams
You can list all live streams you have to see what's available or send a request that filters your live streams. This code sample shows you how to list all live streams:
List a subset of live streams
You can send in a request to filter based on the different parameters for a live stream. You can filter on:
streamKey- A string representing the stream key that allows you to stream videos to a specific live stream container
name- A string representing the name of your live stream
sortBy- A string indicating how you want the results sorted, options include createdAt, publishedAt, name. createdAt - the time a livestream was created using the specified streamKey. publishedAt - the time a livestream was published using the specified streamKey. name - the name of the livestream. If you choose one of the time-based options, the time is presented in ISO-8601 format.
sortOrder- A string indicating the order in which to sort everything. Allowed: asc, desc. Ascending for date and time means that earlier values precede later ones. Descending means that latter values precede earlier ones. The title is 0-9 and A-Z ascending and Z-A, 9-0 descending.
currentPage- Choose the search results page to return—minimum value: 1.
pageSize- Choose the number of results per page. Allowed values: 1-100, default is 25.
List live streams using your dashboard
You can also view all your live stream containers from the dashboard. Do the following:
Log in to your dashboard.
From the menu on the left, click Live streams.
On the Live streams screen, you can see all your live streams and filter them by title.
Listing live streams is useful when you're trying to find a particular live stream for your video project.
Was this page helpful?