/

docs

Log inSign up
GuidesAPI Reference

CONTENT

Overview

Start live streaming

Getting started tutorial

Configure broadcast software

Get an API key

Verify a live stream is active

Create a stream

Playback a live stream

Record a live stream session

Stream delivery via CDN

Redundant back-up transcoding

Tips for reducing latency

Handling disconnects

Debug live stream issues

Create paywall

Supported codecs and workflows

API Requests

Using livepeer.com in your app

Clone an example app

Live streaming from your app

Selecting a video player for your app

Use a custom domain for live streaming

Per stream metrics

Usage and Billing

#Per stream metrics

If you are operating a live-streaming or user generated content platform, you will want to know the total duration of the "parent" stream object and the duration of a "child" stream session.

#sourceSegmentsDuration

The value of sourceSegmentsDuration returned is the duration in seconds of the asset source processed by Livepeer.com. On the parent stream object, this value equates to the total amount of source video ingested by Livepeer.com all time. On the session object, this value is the length of the live stream session (or the session recording).

GET /stream/{id} to retrieve a stream object

curl -H 'authorization: Bearer {api-key}' \
"https://livepeer.com/api/stream/{id}"

GET /session/{id} to retrieve a session object

curl -H 'authorization: Bearer {api-key}' \
"https://livepeer.com/api/session/{id}"

200 OK example response

{
"name":"test_stream",
"id":"ijkl61f3-95bd-4971-a7b1-4dcb5d39e78a",
"createdAt":1596081229373,
"streamKey":"abcd-uimq-jtgy-x98v",
"playbackId":"efghb2mxupongp5k",
"isActive":"true",
"lastSeen":1596119750455",
"sourceSegments":1360,
"transcodedSegments":5480,
"sourceSegmentsDuration":2630.53200000000004,
"transcodedSegmentsDuration":10620.1280000000004,
{other asset object keys, like profiles and parentId}
}