## 05 消费分析 > 下列为本章已实现接口；未覆盖指标见文末「待补充」。 #### 社会消费品零售总额 接口: macro_china_consumer_goods_retail 目标地址: http://data.eastmoney.com/cjsj/xfp.html 描述: 东方财富-经济数据-社会消费品零售总额 限量: 单次返回所有历史数据 输入参数 | 名称 | 类型 | 描述 | |-----|-----|-----| | - | - | - | 输出参数 | 名称 | 类型 | 描述 | |---------|---------|----------| | 月份 | object | - | | 当月 | float64 | 注意单位: 亿元 | | 同比增长 | float64 | 注意单位: % | | 环比增长 | float64 | 注意单位: % | | 累计 | float64 | 注意单位: 亿元 | | 累计-同比增长 | float64 | 注意单位: % | 接口示例 ```python import meshare as ms macro_china_consumer_goods_retail_df = ms.macro_china_consumer_goods_retail() print(macro_china_consumer_goods_retail_df) ``` 数据示例 ``` 月份 当月 同比增长 环比增长 累计 累计-同比增长 0 2022年10月份 40271.0 -0.5 6.692277 360575.0 0.6 1 2022年09月份 37745.0 2.5 4.101164 320305.0 0.7 2 2022年08月份 36258.0 5.4 1.081684 282560.0 0.5 3 2022年07月份 35870.0 2.7 -7.413143 246302.0 -0.2 4 2022年06月份 38742.0 3.1 15.485736 210432.0 -0.7 .. ... ... ... ... ... ... 162 2008年05月份 8703.5 21.6 6.896340 42400.7 21.1 163 2008年04月份 8142.0 22.0 0.231436 33697.2 21.0 164 2008年03月份 8123.2 21.5 -2.770895 25555.2 20.6 165 2008年02月份 8354.7 19.1 -7.960517 17432.0 20.2 166 2008年01月份 9077.3 21.2 0.687720 9077.3 21.2 ``` #### 乘联会乘用车批发/零售 接口: car_market_total_cpca 目标地址: http://data.cpcadata.com/TotalMarket 描述: 乘联会总体市场月度数据。可取狭义/广义乘用车的产量、批发、零售、出口；消费高频跟踪常用「狭义乘用车」的批发与零售。返回表为当年与上年对照（万辆）。 限量: 单次返回指定 symbol 与 indicator 的当年及上年各月数据 输入参数 | 名称 | 类型 | 描述 | |----|----|----| | symbol | str | `狭义乘用车`（默认）或 `广义乘用车` | | indicator | str | `产量` / `批发` / `零售`（默认）/ `出口` | 输出参数 | 名称 | 类型 | 描述 | |----|----|----| | 月份 | object | 如 `1月`…`12月` | | {上一年}年 | float64 | 单位: 万辆 | | {当年}年 | float64 | 单位: 万辆；未公布月份可为空 | 接口示例 ```python import meshare as ms 零售 = ms.car_market_total_cpca(symbol="狭义乘用车", indicator="零售") 批发 = ms.car_market_total_cpca(symbol="狭义乘用车", indicator="批发") print(零售) print(批发) ``` #### 中汽协汽车产销量 接口: car_sale_caam 目标地址: http://www.caam.org.cn/ ；https://sou.chinanews.com.cn/ 描述: 中国汽车工业协会月度汽车产量与销量。官网「汽车工业产销情况简析」多为配图；本接口按中汽协产销栏目月份，检索中国新闻网转载稿抽取当月/累计产销量及同比（下降为负）。覆盖范围取决于栏目列表与检索稿留存。 限量: 默认回溯最近约 36 个月中可解析到的月份 输入参数 | 名称 | 类型 | 描述 | |----|----|----| | max_months | int | 最多回溯月份数，默认 `36` | | max_pages | int | 扫描中汽协栏目列表最大页数，默认 `15` | 输出参数 | 名称 | 类型 | 描述 | |----|----|----| | 月份 | object | 如 `2026-05` | | 产量-当月值 | float64 | 单位: 万辆 | | 销量-当月值 | float64 | 单位: 万辆 | | 产量-当月同比 | float64 | 单位: % | | 销量-当月同比 | float64 | 单位: % | | 产量-累计值 | float64 | 单位: 万辆 | | 销量-累计值 | float64 | 单位: 万辆 | | 产量-累计同比 | float64 | 单位: % | | 销量-累计同比 | float64 | 单位: % | | 来源链接 | object | 转载稿或中汽协原文 URL | 接口示例 ```python import meshare as ms df = ms.car_sale_caam() print(df.tail()) df = ms.car_sale_caam(max_months=12) print(df[["月份", "产量-当月值", "销量-当月值", "销量-当月同比"]]) ``` #### 消费者信心指数 接口: macro_china_xfzxx 目标地址: https://data.eastmoney.com/cjsj/xfzxx.html 描述: 东方财富网-消费者信心指数 限量: 单次返回所有历史数据 输入参数 | 名称 | 类型 | 描述 | |-----|-----|-----| | - | - | - | 输出参数 | 名称 | 类型 | 描述 | |--------------|---------|---------| | 月份 | object | - | | 消费者信心指数-指数值 | float64 | - | | 消费者信心指数-同比增长 | float64 | 注意单位: % | | 消费者信心指数-环比增长 | float64 | 注意单位: % | | 消费者满意指数-指数值 | float64 | - | | 消费者满意指数-同比增长 | float64 | 注意单位: % | | 消费者满意指数-环比增长 | float64 | 注意单位: % | | 消费者预期指数-指数值 | float64 | - | | 消费者预期指数-同比增长 | float64 | 注意单位: % | | 消费者预期指数-环比增长 | float64 | 注意单位: % | 接口示例 ```python import meshare as ms macro_china_xfzxx_df = ms.macro_china_xfzxx() print(macro_china_xfzxx_df) ``` 数据示例 ``` 月份 消费者信心指数-指数值 ... 消费者预期指数-同比增长 消费者预期指数-环比增长 0 2022年09月份 87.2 ... -28.995984 0.568828 1 2022年08月份 87.0 ... -26.134454 -1.897321 2 2022年07月份 87.9 ... -25.581395 -1.538462 3 2022年06月份 88.9 ... -27.949327 3.762828 4 2022年05月份 86.8 ... -30.063796 1.036866 .. ... ... ... ... ... 184 2007年05月份 112.8 ... 2.975654 0.351494 185 2007年04月份 112.3 ... 2.430243 1.426025 186 2007年03月份 111.0 ... 0.718133 -1.232394 187 2007年02月份 111.8 ... 2.805430 -0.525394 188 2007年01月份 112.4 ... 3.442029 -0.609225 ``` #### 城镇调查失业率 接口: macro_china_urban_unemployment 目标地址: https://data.stats.gov.cn/dg/website/page.html#/pc/national/monthData 描述: 国家统计局-月度数据-城镇调查失业率 限量: 单次返回所有历史数据 输入参数 | 名称 | 类型 | 描述 | |-----|-----|-----| | - | - | - | 输出参数 | 名称 | 类型 | 描述 | |-------|---------|----| | date | object | 年月 | | item | object | - | | value | float64 | - | 接口示例 ```python import meshare as ms macro_china_urban_unemployment_df = ms.macro_china_urban_unemployment() print(macro_china_urban_unemployment_df) ``` 数据示例 ``` date item value 0 201801 全国城镇25—59岁劳动力失业率 4.4 1 201801 全国城镇调查失业率 5.0 2 201802 全国城镇调查失业率 5.0 3 201802 全国城镇25—59岁劳动力失业率 4.5 4 201803 全国城镇调查失业率 5.1 .. ... ... ... 283 202601 全国城镇本地户籍劳动力失业率 5.3 284 202601 全国城镇调查失业率 5.2 285 202602 全国城镇外来户籍劳动力失业率 5.0 286 202602 全国城镇本地户籍劳动力失业率 5.4 287 202602 全国城镇调查失业率 5.3 [288 rows x 3 columns] ``` #### 民航客座率及载运率 接口: macro_china_passenger_load_factor 目标地址: http://finance.sina.com.cn/mac/#industry-20-0-31-1 描述: 国家统计局-民航客座率及载运率 限量: 单次返回所有历史数据 输入参数 | 名称 | 类型 | 描述 | |----|----|----| | - | - | - | 输出参数 | 名称 | 类型 | 描述 | |------|---------|---------| | 统计年度 | object | 年月 | | 客座率 | float64 | 注意单位: % | | 载运率 | float64 | 注意单位: % | 接口示例 ```python import meshare as ms macro_china_passenger_load_factor_df = ms.macro_china_passenger_load_factor() print(macro_china_passenger_load_factor_df) ``` 数据示例 ``` 统计时间 客座率 载运率 0 2023.7 81.20 68.50 1 2023.6 78.60 69.30 2 2023.5 74.30 65.90 3 2023.4 75.90 66.10 4 2023.3 74.70 66.20 .. ... ... ... 202 2006.6 72.00 64.60 203 2006.5 71.30 64.40 204 2006.4 76.30 69.00 205 2006.3 72.40 67.50 206 2006.2 72.70 64.60 [207 rows x 3 columns] ``` #### 待补充 电影票房、地铁客运/拥堵等高频服务消费代理尚待封装；中汽协接口依赖新闻转载稿，覆盖受检索留存限制。