省市市场总览（V2 复用接口）

接口信息

项目	内容
请求方式	`GET`
接口路径	`/api/bs_v5/province_city_analysis/overview`
数据范围	全国、省份、城市
数据时效	最新月份或指定历史月份
V2 改动	新增 `area_level=country`；人口优先读取 V2 年度 ADS

请求参数

参数	类型	必填	示例	说明
`area_level`	string	是	`city`	`country`、`province` 或 `city`
`area_id`	integer	是	`440100`	对应 DIM ID
`year_month`	string	否	`2026-06`	`YYYYMM` 或 `YYYY-MM`，不传取最新月份

成功响应字段

字段路径	类型	可空	中文含义
`code` / `message`	integer / string	否	业务状态码 / 响应信息
`data.area`	object	否	地区层级、ID、名称和行政归属信息
`data.period.stat_month`	string	否	实际统计月份，`YYYYMM`
`data.page_meta`	object	是	页面数据最新入库时间
`data.profile`	object	否	常住人口、面积、人均收入和支出
`data.profile.resident_population_stat_year`	integer	是	常住人口统计年度
`data.profile.resident_population_source`	object	是	人口数据来源及递补信息
`data.country_profile`	object	否	全国基础画像
`data.market`	object	否	门店数、品牌数、均价、连锁化率、每万人门店数
`data.last_month_operation`	object	否	上月新开、闭店及倒闭率
`data.quality.calculation_version`	string	是	指标计算版本

成功响应示例

{"code":200,"message":"success","data":{"area":{"area_level":"city","area_id":440100,"area_name":"广州市"},"period":{"stat_month":"202606"},"page_meta":{"updated_at":"2026-08-27 18:00:00","updated_date":"2026-08-27"},"profile":{"resident_population":18900000,"resident_population_stat_year":2025,"resident_population_source":{"data_source":"hc","source_name":"红黑","is_fallback":false,"fallback_from":null},"land_area_km2":7434.4,"per_capita_income":83400,"per_capita_spending":52000},"country_profile":{"country_id":1,"country_name":"中国","per_capita_income":41314,"per_capita_spending":28227},"market":{"active_store_count":75000,"brand_count":12000,"weighted_avg_price":62.5,"stores_per_10000_people":40},"last_month_operation":{"period":"202605","new_store_count":1200,"close_store_count":800,"close_store_rate_pct":"1.10%"},"quality":{"calculation_version":"province_city_analysis_v2"}}}

异常码

code	说明
`400`	参数错误
`404`	未找到对应区域或月份指标
`500`	服务端异常

返回响应

🟢200成功示例

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "area": {
            "area_level": "city", 
            "area_id": 100,
            "area_name": "蚌埠市",
            "country_id": 1,
            "country_name": "中华人民共和国",
            "province_id": 12,
            "province_name": "安徽省",
            "city_id": 100,
            "city_name": "蚌埠市",
            "city_level_id": 4,
            "city_level_name": "三线",
            "city_intro": null
        },
        "period": {
            "stat_month": "202607"
        },
        "profile": {
            "resident_population": 3262000,
            "land_area_km2": 5959.0,
            "per_capita_income": null,
            "per_capita_spending": null
        },
        "country_profile": {
            "country_id": 1,
            "country_name": "中华人民共和国",
            "per_capita_income": null,
            "per_capita_spending": null
        },
        "market": {
            "active_store_count": 767,
            "active_store_yoy_pct": null,
            "active_store_mom_pct": "5.07%",
            "brand_count": 241,
            "brand_yoy_pct": null,
            "weighted_avg_price": 49.96,
            "weighted_avg_price_yoy_pct": null,
            "brand_chain_rate_pct": null,
            "stores_per_10000_people": 2.35
        },
        "last_month_operation": {
            "period": "202606",
            "new_store_count": 18,
            "close_store_count": 28,
            "close_store_rate_pct": "3.84%"
        },
        "quality": {
            "category_mapping_rate_pct": "23.08%",
            "calculation_version": "v1.0.0"
        }
    }
}

省市市场总览(v6.66接口扩展)

省市市场总览（V2 复用接口）

接口信息

请求参数

成功响应字段

成功响应示例

异常码

请求参数

请求示例代码

返回响应

省市市场总览(v6.66接口扩展)

省市市场总览（V2 复用接口）#

接口信息#

请求参数#

成功响应字段#

成功响应示例#

异常码#

请求参数

请求示例代码

返回响应

省市市场总览（V2 复用接口）

接口信息

请求参数

成功响应字段

成功响应示例

异常码