Query the delivery domains' location traffic

Query the delivery domains' location traffic.

Request

Request-Line

GET /lls/v1.0/analytics/delivery/locationTraffic

Request Parameters

Query Parameters

Parameter	Type	Required	Description
domains	Array	Mandatory	Array of delivery domains.
started	Timestamp	Mandatory	Timestamp of started time. Format yyyyMMddTHHmmssZ UTC time.
ended	Timestamp	Mandatory	Timestamp of ended time. Format yyyyMMddTHHmmssZ UTC time. Interval between start time and end time cannot be longer than 24 hours.
interval	String	Optional	Interval of data spot, could be "minute", "day". For "minute", data spot is for 5 minutes, and for "day", data spot is one day. Default is "minute".

Response

Response Body

Parameter	Type	Required	Description
--	Array	Mandatory	Array of Location Traffic Summary Object

Object: Location Traffic Summary

Parameter	Type	Required	Description
domain	String	Mandatory	Delivery domain name.
viewersLocationVolumes	Array	Mandatory	Array of Location Traffics Object

Object: Location Traffics

Parameter	Type	Required	Description
timestamp	Timestamp	Mandatory	Exampling timestamp in UTC timezone.
locationVolumes	Array	Mandatory	Array of Location Traffic Object

Object: Location Traffic

Parameter	Type	Required	Description
country	String	Mandatory	country code of the ingest node. refer to ISO 3166-1 Alpha-2.
value	Number	Mandatory	Traffic value. Unit is byte.

Status Codes, Error Codes and Error Messages

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

Examples

Query Delivery HTTP Status Code

Request

GET /lls/v1.0/analytics/delivery/locationTraffic?domains=live.example.com&domains=live2.example.com&started=20250518T173000Z&ended=20250518T174000Z

Successful Response Body

[
  {
    "domain": "live2.example.com",
    "viewersLocationVolumes": [
      {
        "timestamp": "2025-05-18T17:35:00Z",
        "locationVolumes": [
          {
            "country": "VN",
            "value": 342152828
          },
          {
            "country": "SG",
            "value": 4458375
          }
        ]
      }
    ]
  },
  {
    "domain": "www.example2.com",
    "viewersLocationVolumes": [
      {
        "timestamp": "2025-05-18T17:40:00Z",
        "locationVolumes": [
          {
            "country": "VN",
            "value": 458754387
          },
          {
            "country": "SG",
            "value": 3487548
          }
        ]
      }
    ]
  }
]

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