统计接口（旧版）
更新时间：2025-08-21
接口描述
各项统计指标查询
/v2/stat/[metric] 默认接口请求频率限制：30次/秒。
pv/qps查询接口
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/stat/pv | 查询域名pv请求量 |
URL参数：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| domain | 可选 | String | 查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名pv数之和 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度90天 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间 |
| period | 可选 | Int | 查询结果的粒度，单位秒，可选值为300,3600,86400 默认为300 |
| withRegion | 可选 | Bool | 查询客户端访问分布详情，当包含此项时，结果中details的记录数不能超过64个 |
| prov | 可选 | String | 查询的省份全拼，默认为空，查询全国数据。不可以与withRegion同时使用。 |
| isp | 可选 | String | 查询的运营商代码，默认为空，查询所有运营商数据。不可以与withRegion同时使用。 |
响应体 (Response Body)
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list类型，参见下表PvDetails内容。 | 数据详情 |
PvDetails内容：
| 参数 | 类型 | 说明 |
|---|---|---|
| timestamp | Timestamp | 时间点，UTC时间 |
| pv | Int | 统计时间段内的请求量 |
| qps | Int | 统计时间段内的平均qps |
| regions | list类型，参见下表PvRegionData内容 | 客户端访问分布数据，当请求包含withRegion参数时包含此项 |
PvRegionData内容：
| 参数 | 类型 | 说明 |
|---|---|---|
| location | String | 客户端所在省份、地区 |
| isp | String | 客户端所属运营商 |
| pv | Int | 统计时间段内的请求量 |
| qps | Int | 统计时间段内的平均qps |
请求示例
Plain Text
1GET /v2/stat/pv?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
2Host: cdn.baidubce.com返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Length: 190
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6
7{
8 "details":
9 [
10 {"timestamp":"2016-10-13T00:00:00Z","pv":1998202,"qps":556},
11 {"timestamp":"2016-10-13T01:00:00Z","pv":2169932,"qps":603}
12 ]
13}带宽&流量查询接口
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/stat/flow | 查询域名流量记录 |
URL参数：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| domain | 可选 | String | 查询的域名，可多个域名用逗号分隔，返回内容为所有域名的数据之和，如不指定则返回该用户所有域名流量之和 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间 |
| period | 可选 | Int | 查询结果的粒度，单位秒，可选值为300,3600,86400, 默认为300 |
| withRegion | 可选 | Bool | 查询客户端访问分布详情，当包含此项时，结果中details的记录数不能超过64个 |
| prov | 可选 | String | 查询的省份全拼，默认为空，查询全国数据。不可以与withRegion同时使用。 |
| isp | 可选 | String | 查询的运营商代码，默认为空，查询所有运营商数据。不可以与withRegion同时使用。 |
| level | 可选 | String | 查询边缘节点或者中心节点带宽。不可以与withRegion同时使用，可以填写“edge”或者“internal”。 |
响应体 (Response Body)
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list参见下表 |
数据详情 |
FlowDetail内容：
| 参数 | 类型 | 说明 |
|---|---|---|
| timestamp | Timestamp | 时间点，UTC时间 |
| flow | Int | 统计时间段内的传输字节数 |
| bps | Int | 统计时间段内的平均bps |
| regions | list参见下表 |
客户端访问分布数据，当请求中的withRegion为true时包含此项 |
FlowRegionData内容：
| 参数 | 类型 | 说明 |
|---|---|---|
| location | String | 客户端所在省份、地区 |
| isp | String | 客户端所属运营商 |
| flow | Int | 统计时间段内的传输字节数 |
| bps | Int | 统计时间段内的平均bps |
请求示例
Plain Text
1GET /v2/stat/flow?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
2Host: cdn.baidubce.com响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Length: 190
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6
7{
8 "details":
9 [
10 {"timestamp":"2016-10-13T00:00:00Z","flow":42652354694,"bps":94783010},
11 {"timestamp":"2016-10-13T01:00:00Z","flow":45766298297,"bps":101702885}
12 ]
13}回源流量查询接口
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/stat/srcflow | 查询域名回源流量记录 |
URL参数：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| domain | 可选 | String | 查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名回源流量之和 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间 |
| period | 可选 | Int | 查询结果的粒度，单位秒，可选值为300,3600,86400, 默认为300 |
响应体 (Response Body)
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list参见下表 |
数据详情 |
请求示例
Plain Text
1GET /v2/stat/srcflow?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
2Host: cdn.baidubce.com响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Length: 190
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6{
7 "details":
8 [
9 {"timestamp":"2016-10-13T00:00:00Z","flow":741119469,"bps":1646932},
10 {"timestamp":"2016-10-13T01:00:00Z","flow":905548590,"bps":2012330}
11 ]
12}字节命中率查询接口
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/stat/hitrate | 查询字节命中率 |
URL参数：
| 参数 | 是否可选 | 类型 | 说明 |
|---|---|---|---|
| domain | 可选 | String | 查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名字节命中率的平均值 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间 |
| granularity | 可选 | Int | 查询结果的粒度，单位秒，可选值为60,300,3600 默认为300 |
响应体 (Response Body)
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list类型，HitRateDetails内容项详细解释： - timestamp：Timestamp类型，表示时间点。 - hitrate：Double类型，表示统计时间段内的字节命中率。 |
数据详情 |
请求示例
Plain Text
1GET /v2/stat/hitrate?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
2Host: cdn.baidubce.com响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Length: 190
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6
7{
8 "details":
9 [
10 {"timestamp":"2016-10-13T00:00:00Z","hitrate":0.98262418395615},
11 {"timestamp":"2016-10-13T01:00:00Z","hitrate":0.98021363702777}
12 ]
13}状态码统计查询接口
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/stat/httpcode | 查询域名状态码统计 |
URL参数：
| 参数 | 是否可选 | 类型 | 说明 |
|---|---|---|---|
| domain | 可选 | String | 查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名状态码计数 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间 |
| period | 可选 | Int | 查询结果的粒度，单位秒，可选值为300,3600,86400, 默认为300 |
| withRegion | 可选 | Bool | 查询客户端访问分布详情，当包含此项时，结果中details的记录数不能超过64个 |
| prov | 可选 | String | 查询的省份全拼，默认为空，查询全国数据。不可以与withRegion同时使用。 |
| isp | 可选 | String | 查询的运营商代码，默认为空，查询所有运营商数据。不可以与withRegion同时使用。 |
响应体（Response Body）
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list参见下表 |
数据详情 |
HttpCodeDetails内容：
| 参数 | 类型 | 说明 |
|---|---|---|
| timestamp | Timestamp | 时间点，UTC时间 |
| counters | list参见下表 |
HTTP状态码计数 |
| regions | list参见下表 |
按客户端访问地域分布的数据详情 |
HttpCodeRegionData内容：
| 参数 | 类型 | 说明 |
|---|---|---|
| location | String | 客户端所在省份、地区 |
| isp | String | 客户端所属运营商 |
| counters | list参见下表 |
HTTP状态码计数 |
KvCounter内容：
| 参数 | 类型 | 说明 |
|---|---|---|
| name | String | 统计项 |
| value | Int | 统计计数 |
请求示例
Plain Text
1GET /v2/stat/httpcode?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
2Host: cdn.baidubce.com返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Length: 190
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6
7{
8 "details":
9 [
10 {
11 "timestamp":"2016-10-13T00:00:00Z",
12 "counters": [
13 {"name":"504","value": 12},
14 {"name":"502", "value": 18},
15 {"name":"502", "value": 24},
16 {"name": "206", "value": 66},
17 {"name": "200", "value":1759884},
18 {"name": "304", "value": 259405},
19 {"name": "499", "value": 602},
20 {"name": "404", "value": 1902}
21 ]
22 },
23 {
24 "timestamp":"2016-10-13T01:00:00Z",
25 "counters": [
26 {"name":"504","value": 12},
27 {"name":"502", "value": 18},
28 {"name":"502", "value": 24},
29 {"name": "206", "value": 66},
30 {"name": "200", "value":1759884},
31 {"name": "304", "value": 259405},
32 {"name": "499", "value": 602},
33 {"name": "404", "value": 1902}
34 ],
35 }
36 ]
37}TopN url查询接口
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/stat/topn/url | 查询top100 url列表 |
url参数：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| domain | 可选 | String | 查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名的top100 url列表 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间 |
| period | 可选 | Int | 查询结果的粒度，单位秒，可选值为3600,86400, 默认为3600 |
响应体（Response Body）
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list类型，TopUrlDetails内容项解释如下： - timestamp：Timestamp类型，表示时间点，UTC时间。 - counters：list类型，表示Top100 url统计。KvCounter内容项解释如下： - name：String类型，表示统计项。 - value：Int类型，表示统计计数。 |
数据详情 |
请求示例：
Plain Text
1GET /v2/stat/topn/url?domain=my.test.com&endTime=2016-10-22T03%3A01%3A00Z&period=3600&startTime=2016-10-22T01%3A57%3A00Z HTTP/1.1
2Host: cdn.baidubce.com响应示例：
Plain Text
1HTTP/1.1 200 OK
2Content-Length: 7113
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6
7{
8 "details": [
9 {
10 "timestamp": "2016-10-22T02:00:00Z",
11 "counters":
12 [
13 {"name":"http://my.test.com/path/to/file1.png", "value": 2551},
14 {"name":"http://my.test.com/path/to/file2.gif", "value": 1195},
15 {"name":"http://my.test.com/path/to/file3.jpg", "value": 932},
16 {"name":"http://my.test.com/path/to/file4.mp4", "value": 846},
17 {"name":"http://my.test.com/path/to/file5.css", "value": 544},
18 {"name":"http://my.test.com/path/to/file6.js", "value": 326},
19 {"name":"http://my.test.com/path/to/file7.flv", "value": 122},
20 {"name":"http://my.test.com/path/to/file8.zip", "value": 116},
21 {"name":"http://my.test.com/path/to/file9.doc", "value": 98},
22 {"name":"http://my.test.com/path/to/file10.mp3", "value": 76},
23 {"name":"http://my.test.com/path/to/file11.pdf", "value": 18}
24 ]
25 },
26 {
27 "timestamp": "2016-10-22T03:00:00Z",
28 "counters":
29 [
30 {"name":"http://my.test.com/path/to/file1.png", "value": 2382},
31 {"name":"http://my.test.com/path/to/file2.gif", "value": 1245},
32 {"name":"http://my.test.com/path/to/file3.jpg", "value": 923},
33 {"name":"http://my.test.com/path/to/file4.mp4", "value": 811},
34 {"name":"http://my.test.com/path/to/file5.css", "value": 532},
35 {"name":"http://my.test.com/path/to/file6.js", "value": 423},
36 {"name":"http://my.test.com/path/to/file7.flv", "value": 209},
37 {"name":"http://my.test.com/path/to/file8.zip", "value": 155},
38 {"name":"http://my.test.com/path/to/file9.doc", "value": 84},
39 {"name":"http://my.test.com/path/to/file10.mp3", "value": 80},
40 {"name":"http://my.test.com/path/to/file11.pdf", "value": 32}
41 ]
42 }
43 ]
44}TopN referer查询接口
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/stat/topn/referer | 查询top100 referer |
URL参数：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| domain | 可选 | String | 查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名的top100 referer |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间 |
| period | 可选 | Int | 查询结果的粒度，单位秒，可选值为3600,86400, 默认为3600 |
响应体（Response Body）
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list类型，TopRefererDetails内容项详细解释如下： - timestamp：Timestamp类型，表示时间点，UTC时间。 - counters：list类型，表示Top 100 refer统计计数。KvCounter内容项解释如下： - name：String类型，表示统计项。 - value：Int类型，表示统计计数。 |
数据详情 |
请求示例：
Plain Text
1GET /v2/stat/topn/referer?domain=my.test.com&endTime=2016-10-22T02%3A01%3A00Z&period=3600&startTime=2016-10-22T01%3A57%3A00Z HTTP/1.1
2Host: cdn.baidubce.com 响应示例：
Plain Text
1HTTP/1.1 200 OK
2Content-Length: 180
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6
7{
8 "details":
9 [
10 {
11 "timestamp":"2016-10-22T02:00:00Z",
12 "counters":
13 [
14 {"name":"-", "value":53687},
15 {"name":"i1.my.test.com", "value":752},
16 {"name":"i2.my.test.com", "value":393},
17 {"name":"i3.my.test.com", "value":1}
18 ]
19 }
20 ]
21}uv查询接口
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/stat/uv | 查询域名uv请求量 |
URL参数：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| domain | 可选 | String | 查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名uv之和 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度90天 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间 |
| period | 可选 | Int | 查询结果的粒度，单位秒，可选值为3600,86400, 默认为3600 |
| withRegion | 可选 | 查询客户端访问分布详情，当包含此项时，结果中details的记录数不能超过64个 |
响应体
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list |
数据详情 |
UvDetails内容
| 参数 | 类型 | 说明 |
|---|---|---|
| timestamp | Timestamp | 时间点，UTC时间 |
| uv | Int | 统计时间段内的请求量 |
| regions | list |
客户端访问分布数据，当请求包含withRegion参数时包含此项 |
UvRegionData内容
| 参数 | 类型 | 说明 |
|---|---|---|
| location | String | 客户端所在省份、地区 |
| isp | String | 客户端所属运营商 |
| uv | Int | 统计时间段内的请求量 |
请求示例：
Plain Text
1GET /v2/stat/uv?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
2Host: cdn.baidubce.com 响应示例：
Plain Text
1HTTP/1.1 200 OK
2Content-Length: 190
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6
7{
8 "details":
9 [
10 {"timestamp":"2016-10-13T00:00:00Z","uv":1998202},
11 {"timestamp":"2016-10-13T01:00:00Z","uv":2169932}
12 ]
13}平均速率查询接口
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/stat/avgspeed | 查询平均速率记录 |
URL参数：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| domain | 可选 | String | 查询的域名，可多个域名用逗号分隔，如不指定则返回该用户所有域名平均速率的均值 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC时间。endTime与startTime最大时间跨度31天 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间 |
| period | 可选 | Int | 查询结果的粒度，单位秒，可选值为300,3600,86400, 默认为3600 |
响应体：
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list<AvgSpeedDetails> | 数据详情 |
AvgSpeedDetails内容
| 参数 | 类型 | 说明 |
|---|---|---|
| timestamp | Timestamp | 时间点，UTC时间 |
| avgspeed | Int | 统计时间段内的平均速率 |
请求示例：
Plain Text
1GET /v2/stat/avgspeed?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
2Host: cdn.baidubce.com响应示例：
Plain Text
1HTTP/1.1 200 OK
2Content-Length: 190
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6{
7 "details":
8 [
9 {"timestamp":"2016-10-13T00:00:00Z","avgspeed":741119469},
10 {"timestamp":"2016-10-13T01:00:00Z","avgspeed":905548590}
11 ]
12}