餐饮市场分布

接口信息

项目	内容
请求方式	`GET`
接口路径	`/api/bs_v5/province_city_analysis/market_distribution`
数据范围	全国页返回省份；城市页返回区县
数据时效	省份支持最新或指定历史月份；区县仅支持当前门店快照对应的最新月份
数据来源	省份：美团品类榜月度聚合；区县：`dwd_brand_store` 当前有效门店快照

请求参数

参数	类型	必填	示例	说明
`area_level`	string	是	`country`	仅支持 `country` 或 `city`
`area_id`	integer	是	`1`	`country` 为 `dim_country.id`；`city` 为 `dim_city.id`
`year_month`	string	否	`2026-08`	`YYYYMM` 或 `YYYY-MM`；不传取可用最新月份
`sort_by`	string	否	`weighted_avg_price`	排序和返回指标；`active_store_count`（默认）或 `weighted_avg_price`

请求示例

成功响应字段

字段路径	类型	可空	中文含义
`code` / `message`	integer / string	否	业务状态码 / 响应信息
`data.parent_area_level`	string	否	页面父级层级：`country` 或 `city`
`data.parent_area_id`	integer	否	页面父级 DIM ID
`data.stat_month`	string	是	实际统计月份；城市无可用区县快照时为空
`data.item_area_level`	string	否	地图着色粒度：`province` 或 `district`
`data.sort_by/metric_name`	string	否	实际排序字段 / 其中文名称
`data.items`	array	否	地图区域和排行榜数据；城市无区县数据时返回空数组
`data.items[].area_id/area_name`	integer / string	否	省份或区县 DIM ID / 名称
`data.items[].province_id/city_id`	integer	是	行政归属 ID；省份的 `city_id` 为空
`data.items[].district_code`	string	是	区县行政编码；全国省份数据为空
`data.items[].active_store_count`	integer	否	仅 `sort_by=active_store_count` 时返回的营业门店数
`data.items[].active_store_count_rank`	integer	否	仅按营业门店数排序时返回的名次
`data.items[].weighted_avg_price`	number	是	仅 `sort_by=weighted_avg_price` 时返回的店均人均消费
`data.items[].weighted_avg_price_rank`	integer	是	仅按店均人均消费排序时返回的名次；无价格时为空
`data.items[].source_system`	string	否	数据来源：`meituan_category_rank` 或 `hongcan_store_snapshot`
`data.items[].source_snapshot_at`	string	是	区县门店来源快照时间；省份为美团月度汇总更新时间

成功响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "parent_area_level": "city",
    "parent_area_id": 440100,
    "stat_month": "202608",
    "item_area_level": "district",
    "sort_by": "weighted_avg_price",
    "metric_name": "店均人均消费",
    "items": [
      {
        "area_id": 440106,
        "area_name": "天河区",
        "province_id": 44,
        "city_id": 440100,
        "district_code": "440106",
        "weighted_avg_price": 30.58,
        "weighted_avg_price_rank": 3,
        "source_system": "hongcan_store_snapshot",
        "source_snapshot_at": "2026-08-31 10:00:00"
      }
    ]
  }
}

业务规则

全国页只读取省份层 ads_area_market_distribution，用于中国省级地图和省份 Top10；全国总览的门店数仍由美团 province_name='全部' 直出，不由本接口的省份数据汇总。

城市页只读取区县层 ADS，区县营业门店数为当前有效、营业且已映射 district_id 的门店去重数；店均人均消费为有有效价格门店的平均值。地图底图中没有返回数据的区县应显示灰色，不能补为 0。

美团历史门店表没有区县字段，因此区县层不会用当前快照反填指定历史月份。请求非最新月份时，省份可返回历史数据；城市若没有该月区县快照，返回 200 和空 items，由页面展示无数据状态。

接口始终按 sort_by 降序输出 items，同值按 area_id 升序保证顺序稳定。响应只返回当前选中指标及其排名：例如 sort_by=weighted_avg_price 时不返回 active_store_count。

异常码

code	说明
`400`	参数错误，或 `area_level` 不是 `country` / `city`
`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.70新接口)

餐饮市场分布

接口信息

请求参数

请求示例

成功响应字段

成功响应示例

业务规则

异常码

请求参数

请求示例代码

返回响应

餐饮市场分布(v6.70新接口)

餐饮市场分布#

接口信息#

请求参数#

请求示例#

成功响应字段#

成功响应示例#

业务规则#

异常码#

请求参数

请求示例代码

返回响应

餐饮市场分布

接口信息

请求参数

请求示例

成功响应字段

成功响应示例

业务规则

异常码