Record and archive live streams

Learn how to record your live streams, retrieve the recorded sessions, and replay them for on-demand viewing or future broadcasts.

FastPix automatically records every live stream. After the live stream ends, it is stored as an on-demand media asset, allowing users to replay it anytime. This functionality ensures that all live content is preserved and can be accessed even after the stream has concluded.

How Live Stream Recording Works

All live streams are automatically recorded—there is no need to manually start recording.
After the live stream ends, it is stored as a media asset and assigned a mediaId.
The mediaId is required to fetch recording details and construct the playback URL.
Recorded media is available on-demand through API requests.

Where to find your recordings

Open the FastPix dashboard.
Go to Products > Live Streams.
Select the live stream you want to review.
Scroll to the Media Details section.
Here, you’ll see one or more Media IDs associated with the live stream recording.

Retrieve a recorded stream

After a live stream is completed, follow these steps to access and replay the recording:

Get the Media ID

There are two ways to obtain the mediaId of the recorded live stream:

Through webhook event:

When a live stream recording is ready, FastPix triggers a webhook event.
The event payload contains the mediaId of the recorded media.

Through live stream API:

Use the Get stream by ID endpoint to retrieve live stream details.
After the recording is available, the response includes the mediaId.

Fetch media details

After you have the mediaId, use the Get media by ID endpoint to retrieve playback details.

Response:
This response includes the playbackId, which is necessary to construct the stream URL.

Response example

1 {
2   "success": true,
3   "data": {
4     "thumbnail": "https://images.fastpix.com/837f028b-dcaf-4c23-b368-3748641f74ac/thumbnail.png",
5     "id": "cfeec1a3-6cbd-40df-a425-2ed7f8f72ced",
6     "workspaceId": "6dc2b4e0-0615-42fd-a580-1f4aad932dfe",
7     "metadata": {
8       "key1": "value1"
9     },
10     "maxResolution": "1080p",
11     "sourceResolution": "1080p",
12     "status": "Ready",
13     "sourceAccess": false,
14     "playbackIds": [
15       {
16         "id": "837f028b-dcaf-4c23-b368-3748641f74ac",
17         "accessPolicy": "public",
18         "accessRestrictions": {
19           "domains": {
20             "defaultPolicy": "allow",
21             "allow": [],
22             "deny": []
23           },
24           "userAgents": {
25             "defaultPolicy": "allow",
26             "allow": [],
27             "deny": []
28           }
29         }
30       }
31     ],
32     "tracks": [
33       {
34         "id": "f301a2a1-b40d-40fa-b419-4d0cd92a62f8",
35         "type": "video",
36         "width": 1920,
37         "height": 1080,
38         "frameRate": "30/1",
39         "closedCaptions": false
40       }
41     ],
42     "isAudioOnly": false,
43     "subtitleAvailable": true,
44     "duration": "00:00:10",
45     "frameRate": "30/1",
46     "aspectRatio": "16:9",
47     "createdAt": "2025-01-09T06:44:44.617138Z",
48     "updatedAt": "2025-01-09T06:44:53.742648Z"
49   }
50 }

Construct the playback URL

Using the playbackId, generate the playback URL to stream the recorded media:

Example

https://stream.fastpix.com/{PLAYBACK_ID}.m3u8

You can use this URL (with .m3u8 extension) in other video players as per your use case.

Refer to the player guide for more details on integrating with the FastPix video player. You can further customize your player interface and video playback experience as per your requirements.

To directly stream your video on a browser, you can also use the playback stream URL which is sharable. Simply preview your video by putting the playbackId on the stream URL.

Example

https://play.fastpix.com/?playbackId={PLAYBACK_ID}

1	{
2	"success": true,
3	"data": {
4	"thumbnail": "https://images.fastpix.com/837f028b-dcaf-4c23-b368-3748641f74ac/thumbnail.png",
5	"id": "cfeec1a3-6cbd-40df-a425-2ed7f8f72ced",
6	"workspaceId": "6dc2b4e0-0615-42fd-a580-1f4aad932dfe",
7	"metadata": {
8	"key1": "value1"
9	},
10	"maxResolution": "1080p",
11	"sourceResolution": "1080p",
12	"status": "Ready",
13	"sourceAccess": false,
14	"playbackIds": [
15	{
16	"id": "837f028b-dcaf-4c23-b368-3748641f74ac",
17	"accessPolicy": "public",
18	"accessRestrictions": {
19	"domains": {
20	"defaultPolicy": "allow",
21	"allow": [],
22	"deny": []
23	},
24	"userAgents": {
25	"defaultPolicy": "allow",
26	"allow": [],
27	"deny": []
28	}
29	}
30	}
31	],
32	"tracks": [
33	{
34	"id": "f301a2a1-b40d-40fa-b419-4d0cd92a62f8",
35	"type": "video",
36	"width": 1920,
37	"height": 1080,
38	"frameRate": "30/1",
39	"closedCaptions": false
40	}
41	],
42	"isAudioOnly": false,
43	"subtitleAvailable": true,
44	"duration": "00:00:10",
45	"frameRate": "30/1",
46	"aspectRatio": "16:9",
47	"createdAt": "2025-01-09T06:44:44.617138Z",
48	"updatedAt": "2025-01-09T06:44:53.742648Z"
49	}
50	}