beta/
docs
/
overview
OverviewGuidesAPI Reference
Log inSign up
beta/
docs
/
overview
OverviewGuidesAPI Reference
Sign upLogin
API Reference
Introduction
Stream
The stream object
Ingest

Ingest

The Livepeer.com API ingest endpoint references stream ingest data centers on the Livepeer network. In the JSON response, each data center region is three letters, the airport code of the server location.

Use /ingest with ?first=false appended to discover all available ingest and playback URL pairs. Ingest and playback URLs for each livestream session must be from the same region.

curl "https://livepeer.com/api/ingest?first=false"

Remove the appended filter to find out which ingest data center is closest.

curl "https://livepeer.com/api/ingest"

200 OK

[
{
ingest: "rtmp://<reg>-rtmp.livepeer.com/live",
playback: "https://<reg>-cdn.livepeer.com/hls",
base:"https://<reg>-cdn.livepeer.com/"
}
]

Attributes

ParameterTypeDescription
basestringBase URL for the playback URL.
ingeststringBase URL used to to configure the broadcast software. Pair it with a stream object streamKey.
playbackstringBase URL for HLS playback. Append a stream object playbackId to create the full playback URL.
Livepeer.com
beta
  • Company
  • Home
  • Contact
  • Team
  • Jobs
  • Livepeer, Inc.
  • 223 Bedford Ave PMB 530
    Brooklyn, NY 11211
  • hello@livepeer.com