Query Delivery Bandwidth

Query peak delivery bandwidth in each interval.

Request

Request-Line

Get /lls/v1.0/analytics/delivery/queryDeliveryBandwidth

Request Parameters

Query Parameters

Parameter	Type	Required	Description
domain	String	Mandatory	Ingest domain name
app	String	Optional	Application name
stream	String	Optional	Stream name
region	String	Optional	country code of the ingest node. refer to ISO 3166-1 Alpha-2.
started	Timestamp	Optional	Timestamp of started time in UTC timezone.
ended	Timestamp	Optional	Timestamp of ended time in UTC timezone.
protocol	Enum	Optional	Delivery protocol. The enum value is "http-flv","ll-hls", "hls/dash"

Response

Response Body

Parameter	Type	Required	Description
domain	String	Mandatory	Ingest domain name
stream	String	Optional	Stream name
app	String	Optional	Application name
started	Timestamp	Optional	Timestamp of started time in UTC timezone.
ended	Timestamp	Optional	Timestamp of ended time in UTC timezone.
data	Array	Mandatory	Array of Data Object
protocol	Enum	Optional	Delivery protocol. The enum value is "http-flv","ll-hls", "hls/dash"

Object: Data

Parameter	Type	Required	Description
timestamp	Timestamp	Mandatory	Exampling timestamp in UTC timezone.
deliveryBandwidth	Float	Mandatory	total number of delivery bandwidth. Unit is gbps.

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
400	LLS.Analytics.InvalidTimestamp	Timestamp is empty or invalid.

Examples

Query real-time delivery bandwidth

Request

Get /lls/v1.0/analytics/delivery/querydeliveryBandwidth?domain=live.example.com&app=demoapp HTTP/1.1

Successful Response Body

{
  "domain": "live.example.com",
  "app": "demoapp",
  "data": [
    {
      "timestamp": "20250518T173000Z",
      "deliveryBandwidth": 128238.39
    }
  ]
}

Query delivery bandwidth in specified time range

Request

Get /lls/v1.0/analytics/delivery/querydeliveryBandwidth?domain=live.example.com&app=demoapp&started=20250518T173000Z&ended=20250518T180000Z HTTP/1.1

Successful Response Body

{
  "domain": "live.example.com",
  "app": "demoapp",
  "started": "20250518T173000Z",
  "ended": "20250518T180000Z",
  "data": [
    {
      "timestamp": "20250518T173000Z",
      "deliveryBandwidth": 128332.38
    },
    {
      "timestamp": "20250518T173500Z",
      "deliveryBandwidth": 135475.45
    },
    {
      "timestamp": "20250518T174000Z",
      "deliveryBandwidth": 182395.36
    },
    {
      "timestamp": "20250518T174500Z",
      "deliveryBandwidth": 203443.64
    },
    {
      "timestamp": "20250518T175000Z",
      "deliveryBandwidth": 256886.96
    },
    {
      "timestamp": "20250518T175500Z",
      "deliveryBandwidth": 287376.95
    },
    {
      "timestamp": "20250518T18000Z",
      "deliveryBandwidth": 327626.63
    }
  ]
}

Best Practices

Rate Limiting

Rate Limits

Rate limiting is posed upon the API, please kindly check your API calls to ensure complying with the rate limit below:

• 100 requests per minute
• 1000 requests per hour