- Release Notes and Announcements
- Announcements
- Billing Content Adjustment for Cloud Streaming Services Standard Transcoding and Top Speed Codec Transcoding
- Announcement on the Price Adjustment of CSS Audio/Video Enhancement Feature
- Announcement on the Official Billing for CSS Standby Streams Feature
- CSS to Support H.265 8K and AV1 8K Transcoding
- CSS Adds Support for AV1 Codec and Audio/Video Enhancement
- Notice: CSS to Adjust Prices of Basic Services
- CSS to Adjust Pricing of Third-Party Relay
- Delayed Playback to Become Paid Feature
- Announcements
- User Guide
- Product Introduction
- Purchase Guide
- Pricing Overview
- Basic Services
- Value-Added Services
- Live Transcoding (Watermarking, Stream Mixing, subtitles)
- Live Audio and Video Enhancement
- Live Recording
- Time Shifting (New)
- Live Screencapture
- Live Stream Moderation
- Intelligent Porn Detection
- Live Video Caster
- Relay
- Overview of Basic Fees for Value-Added Features
- Delayed Playback
- Standby Streams
- Real-Time Log Shipping
- DRM Encryption
- Prepaid plan
- Purchase Process
- Changing Billing Modes
- Refund Policy
- Viewing Bills
- Renewal
- Processing for Overdue Payments
- Billing FAQs
- Live Video Broadcasting (LVB)
- Live Event Broadcasting (LEB)
- Live Video Caster
- Console Guide
- Console Overview
- Overview
- Domain Management
- Adding Domain Names
- Managing Domain Names
- Push Domain Name Management
- Push Configuration
- Recording Configuration
- Time Shifting Configuration
- Screencapture and Porn Detection Configuration
- Watermark Configuration
- Callback Configuration
- Standby Stream Configuration
- Latency Control
- IP Blocklist/Allowlist Configuration
- Delayed Playback
- Moderation Configuration
- Remote Authentication Configuration
- Playback Domain Name Management
- Playback Configuration
- Playback Authentication Configuration
- Referer Configuration
- Template Configuration
- HTTPS Configuration
- Region Configuration
- Origin Server Configuration
- Bandwidth Cap Configuration
- IP Blocklist/Allowlist Configuration
- Blocking Playback by Protocol
- Latency Control
- HTTP Response Header Configuration
- Access Control by Region Configuration
- Remote Authentication Configuration
- Certificate Management
- Stream Management
- Package Management
- Feature Configuration
- Relay
- Laboratory
- Billing Usage Statistics
- Monitoring
- Toolkit
- OOTB live
- CAM-Based Access Control
- Feature Guide
- Push and Playback
- Features
- Live Streaming Security
- Global CSS Service
- Callback Notifications
- How to Receive Event Notification
- Stream Pushing Notification
- Recording Event Notification
- Recording Status Event Notification
- Screencapturing Event Notification
- Live Broadcasting Image Audit Event Notification
- Live Streaming Audio Auditing Service Event Notification
- Push Error Event Notifications
- Relay Event Notification
- User Guides for Common Third-Party Tools
- SDK Guide
- API Documentation
- History
- Introduction
- API Category
- Making API Requests
- Monitoring Data Query APIs
- DescribeLiveTranscodeDetailInfo
- DescribeAllStreamPlayInfoList
- DescribeGroupProIspPlayInfoList
- DescribeHttpStatusInfoList
- DescribeLiveDomainPlayInfoList
- DescribeLiveStreamPushInfoList
- DescribePlayErrorCodeDetailInfoList
- DescribePlayErrorCodeSumInfoList
- DescribeProIspPlaySumInfoList
- DescribeProvinceIspPlayInfoList
- DescribeStreamDayPlayInfoList
- DescribeStreamPlayInfoList
- DescribeStreamPushInfoList
- DescribeTopClientIpSumInfoList
- DescribeVisitTopSumInfoList
- Billing Data Query APIs
- Live Transcoding APIs
- Delayed Playback Management APIs
- Domain Name Management APIs
- Watermark Management APIs
- Certificate Management APIs
- Live Stream Mix APIs
- Stream Pulling APIs
- Recording Management APIs
- Time Shifting APIs
- Live Callback APIs
- Screencapturing and Porn Detection APIs
- Authentication Management APIs
- Live Stream Management APIs
- Data Types
- Error Codes
- Ops Guide
- Troubleshooting
- About Pushing
- Playing Method
- Live Streaming Quiz
- FAQs
- SLA
- CSS Policy
- Glossary
- Release Notes and Announcements
- Announcements
- Billing Content Adjustment for Cloud Streaming Services Standard Transcoding and Top Speed Codec Transcoding
- Announcement on the Price Adjustment of CSS Audio/Video Enhancement Feature
- Announcement on the Official Billing for CSS Standby Streams Feature
- CSS to Support H.265 8K and AV1 8K Transcoding
- CSS Adds Support for AV1 Codec and Audio/Video Enhancement
- Notice: CSS to Adjust Prices of Basic Services
- CSS to Adjust Pricing of Third-Party Relay
- Delayed Playback to Become Paid Feature
- Announcements
- User Guide
- Product Introduction
- Purchase Guide
- Pricing Overview
- Basic Services
- Value-Added Services
- Live Transcoding (Watermarking, Stream Mixing, subtitles)
- Live Audio and Video Enhancement
- Live Recording
- Time Shifting (New)
- Live Screencapture
- Live Stream Moderation
- Intelligent Porn Detection
- Live Video Caster
- Relay
- Overview of Basic Fees for Value-Added Features
- Delayed Playback
- Standby Streams
- Real-Time Log Shipping
- DRM Encryption
- Prepaid plan
- Purchase Process
- Changing Billing Modes
- Refund Policy
- Viewing Bills
- Renewal
- Processing for Overdue Payments
- Billing FAQs
- Live Video Broadcasting (LVB)
- Live Event Broadcasting (LEB)
- Live Video Caster
- Console Guide
- Console Overview
- Overview
- Domain Management
- Adding Domain Names
- Managing Domain Names
- Push Domain Name Management
- Push Configuration
- Recording Configuration
- Time Shifting Configuration
- Screencapture and Porn Detection Configuration
- Watermark Configuration
- Callback Configuration
- Standby Stream Configuration
- Latency Control
- IP Blocklist/Allowlist Configuration
- Delayed Playback
- Moderation Configuration
- Remote Authentication Configuration
- Playback Domain Name Management
- Playback Configuration
- Playback Authentication Configuration
- Referer Configuration
- Template Configuration
- HTTPS Configuration
- Region Configuration
- Origin Server Configuration
- Bandwidth Cap Configuration
- IP Blocklist/Allowlist Configuration
- Blocking Playback by Protocol
- Latency Control
- HTTP Response Header Configuration
- Access Control by Region Configuration
- Remote Authentication Configuration
- Certificate Management
- Stream Management
- Package Management
- Feature Configuration
- Relay
- Laboratory
- Billing Usage Statistics
- Monitoring
- Toolkit
- OOTB live
- CAM-Based Access Control
- Feature Guide
- Push and Playback
- Features
- Live Streaming Security
- Global CSS Service
- Callback Notifications
- How to Receive Event Notification
- Stream Pushing Notification
- Recording Event Notification
- Recording Status Event Notification
- Screencapturing Event Notification
- Live Broadcasting Image Audit Event Notification
- Live Streaming Audio Auditing Service Event Notification
- Push Error Event Notifications
- Relay Event Notification
- User Guides for Common Third-Party Tools
- SDK Guide
- API Documentation
- History
- Introduction
- API Category
- Making API Requests
- Monitoring Data Query APIs
- DescribeLiveTranscodeDetailInfo
- DescribeAllStreamPlayInfoList
- DescribeGroupProIspPlayInfoList
- DescribeHttpStatusInfoList
- DescribeLiveDomainPlayInfoList
- DescribeLiveStreamPushInfoList
- DescribePlayErrorCodeDetailInfoList
- DescribePlayErrorCodeSumInfoList
- DescribeProIspPlaySumInfoList
- DescribeProvinceIspPlayInfoList
- DescribeStreamDayPlayInfoList
- DescribeStreamPlayInfoList
- DescribeStreamPushInfoList
- DescribeTopClientIpSumInfoList
- DescribeVisitTopSumInfoList
- Billing Data Query APIs
- Live Transcoding APIs
- Delayed Playback Management APIs
- Domain Name Management APIs
- Watermark Management APIs
- Certificate Management APIs
- Live Stream Mix APIs
- Stream Pulling APIs
- Recording Management APIs
- Time Shifting APIs
- Live Callback APIs
- Screencapturing and Porn Detection APIs
- Authentication Management APIs
- Live Stream Management APIs
- Data Types
- Error Codes
- Ops Guide
- Troubleshooting
- About Pushing
- Playing Method
- Live Streaming Quiz
- FAQs
- SLA
- CSS Policy
- Glossary
1. API Description
Domain name for API request: live.tencentcloudapi.com.
This API is used to query the downstream playback data by district and ISP.
A maximum of 200 requests can be initiated per second for this API.
We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.
2. Input Parameters
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: DescribeGroupProIspPlayInfoList. |
| Version | Yes | String | Common Params. The value used for this API: 2018-08-01. |
| Region | No | String | Common Params. This parameter is not required for this API. |
| StartTime | Yes | String | The start time of the request, supports data query for the last one month, the gap between the start time and the end time cannot exceed one month. Interface request supports two time formats: 1) YYYY-MM-DDThh:mm:ssZ: ISO time format, for details, see ISO Date Format Description 2) YYYY-MM-DD hh:mm:ss: When using this format, it represents Beijing time by default. |
| EndTime | Yes | String | The end time of the request, supports data query for the last one month, the gap between the start time and the end time cannot exceed one month. Interface request supports two time formats: 1) YYYY-MM-DDThh:mm:ssZ: ISO time format,for details,see ISO Date Format Description 2) YYYY-MM-DD hh:mm:ss: When using this format, it represents Beijing time by default. |
| PlayDomains.N | No | Array of String | Playback domain name. If this parameter is left empty, full data will be queried. |
| ProvinceNames.N | No | Array of String | District list. If this parameter is left empty, data for all districts will be returned. |
| IspNames.N | No | Array of String | ISP list. If this parameter is left empty, data of all ISPs will be returned. |
| MainlandOrOversea | No | String | Within or outside Mainland China. Valid values: Mainland (data for Mainland China), Oversea (data for regions outside Mainland China). If this parameter is left empty, data for all regions will be queried. |
3. Output Parameters
| Parameter Name | Type | Description |
|---|---|---|
| DataInfoList | Array of GroupProIspDataInfo | Data content. |
| RequestId | String | The unique request ID, which is returned for each request. RequestId is required for locating a problem. |
4. Example
Example1 Sample request
Input Example
https://live.tencentcloudapi.com/?Action=DescribeGroupProIspPlayInfoList
&StartTime=2019-03-29 09:00:00
&EndTime=2019-03-29 09:10:00
&<Common request parameters>
Output Example
{
"Response": {
"DataInfoList": [
{
"DetailInfoList": [
{
"Bandwidth": 863.073,
"Flux": 6473.05,
"Online": 540,
"Request": 449,
"Time": "2019-03-29 09:00:00"
},
{
"Bandwidth": 891.49,
"Flux": 6686.173,
"Online": 524,
"Request": 455,
"Time": "2019-03-29 09:05:00"
},
{
"Bandwidth": 847.715,
"Flux": 6357.859,
"Online": 612,
"Request": 578,
"Time": "2019-03-29 09:10:00"
}
],
"IspName": "China Telecom",
"ProvinceName": "Guangdong"
},
{
"DetailInfoList": [
{
"Bandwidth": 213.405,
"Flux": 1600.537,
"Online": 132,
"Request": 184,
"Time": "2019-03-29 09:00:00"
},
{
"Bandwidth": 215.738,
"Flux": 1618.032,
"Online": 125,
"Request": 122,
"Time": "2019-03-29 09:05:00"
},
{
"Bandwidth": 226.96,
"Flux": 1702.203,
"Online": 131,
"Request": 131,
"Time": "2019-03-29 09:10:00"
}
],
"IspName": "China Unicom",
"ProvinceName": "Guangdong"
}
],
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}
}
5. Developer Resources
SDK
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
- Tencent Cloud SDK 3.0 for Python
- Tencent Cloud SDK 3.0 for Java
- Tencent Cloud SDK 3.0 for PHP
- Tencent Cloud SDK 3.0 for Go
- Tencent Cloud SDK 3.0 for Node.js
- Tencent Cloud SDK 3.0 for .NET
- Tencent Cloud SDK 3.0 for C++
Command Line Interface
6. Error Code
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| FailedOperation | Operation failed. |
| InternalError | Internal error. |
| InvalidParameter | Invalid parameter. |
| ResourceNotFound.ForbidService | You are blocked. |
| ResourceNotFound.FreezeService | Service suspended. |
| ResourceNotFound.StopService | The service has been suspended due to account arrears. Please top up it to a positive balance to activate the service first. |
| ResourceNotFound.UserDisableService | You disabled the service. |
| UnsupportedOperation | Unsupported operation. |
Yes
No
Was this page helpful?