共同体统计数据查询(门店规模)
接口路径:
https://gateway-smart.shouqianba.com/api/platform/v1/community/store/summary
限流
5 次/秒
说明
- 查询共同体中的门店的总数、活跃门店数、行业分布及省份城市分布数据
请求参数
| 字段 |
类型 |
必须 |
示例值 |
说明 |
| province |
String |
否 |
广东省 |
要查询的省份,不传则返回全部省份的数据 |
| industry |
String |
否 |
餐饮 |
查询的行业,不传则返回全部行业数据 |
返回参数
| 字段 |
类型 |
必须 |
示例值 |
说明 |
| totalStores |
Number |
是 |
6531 |
总门店数 |
| activeStores |
Number |
是 |
6301 |
近一年交易活跃门店数 |
| industryDistribution |
Array |
是 |
|
详见下方行业分布数据结构定义 |
| provinceDistribution |
Array |
是 |
|
详见下方省份分布数据结构定义 |
行业分布数据
| 字段 |
类型 |
必须 |
示例值 |
说明 |
| name |
String |
是 |
餐饮 |
行业名称 |
| count |
Number |
是 |
1331 |
该行业门店数 |
| ratio |
Number |
是 |
0.25 |
该行业门占比 |
省份分布数据
| 字段 |
类型 |
必须 |
示例值 |
说明 |
| name |
String |
是 |
广东省 |
省份名称 |
| count |
Number |
是 |
1331 |
该省份门店数 |
| ratio |
Number |
是 |
0.25 |
该省份门店占比 |
| cityDistribution |
Array |
否 |
|
详见下方城市分布数据结构定义 |
城市分布数据
| 字段 |
类型 |
必须 |
示例值 |
说明 |
| name |
String |
是 |
惠州 |
城市名称 |
| count |
Number |
是 |
201 |
该城市门店数 |
| ratio |
Number |
是 |
0.11 |
该城市门店占比 |
请求数据示例
入参
{
"province": "广东省",
"industry": "餐饮"
}
出参
{
"totalStores": 6531,
"activeStores": 6301,
"industryDistribution": [
{
"name": "餐饮",
"totalStores": 6531,
"activeStores": 6301,
"industryDistribution": [
{
"name": "餐饮",
"count": 1331,
"ratio": 0.20
},
{
"name": "其他行业示例",
"count": 5200,
"ratio": 0.80
}
],
"provinceDistribution": [
{
"name": "广东省",
"count": 1331,
"ratio": 0.25,
"cityDistribution": null
},
{
"name": "其他省份示例",
"count": 5200,
"ratio": 0.75,
"cityDistribution": null
}
]
}
],
"provinceDistribution": [
{
"name": "广东省",
"count": 1331,
"ratio": 0.25,
"cityDistribution": [
{
"name": "惠州",
"count": 201,
"ratio": 0.11
},
{
"name": "广州",
"count": 480,
"ratio": 0.36
},
{
"name": "深圳",
"count": 650,
"ratio": 0.53
}
]
}
]
}