附录：国家统计局通用接口
下列为本章已实现接口；未覆盖指标见文末「待补充」。
国家统计局全国数据
接口: macro_china_nbs_nation
目标地址: https://data.stats.gov.cn/easyquery.htm
描述: 国家统计局全国数据通用接口，包括月度数据、季度数据、年度数据，具体指标见数据官网。
限量: 根据参数返回指定数据
输入参数
| 名称 | 类型 | 描述 |
|---|---|---|
| kind | str | 数据类别，包括：月度数据、季度数据、年度数据。 |
| path | str | 数据路径， 需与kind参数匹配，具体见官网，多层级之间使用 > 连接 。 示例： 国民经济核算 > 支出法国内生产总值 人口 > 总人口 金融业 > 保险系统机构、人员数 > 保险系统机构数 |
| period | str | 时间区间 参考格式如下(英文逗号分割，且不能有多余空格)： 月：201201,201205 季：2012A,2012B,2012C,2012D 年：2012,2013 至今：2013- 最近：last10 |
输出参数
| 名称 | 类型 | 描述 |
|---|---|---|
| - | - | - |
接口示例
import meshare as ms
macro_china_nbs_nation_df = ms.macro_china_nbs_nation(kind="年度数据", path="人口 > 总人口", period="LAST5")
print(macro_china_nbs_nation_df)
数据示例
2022年 2021年 2020年 2019年 2018年
年末总人口(万人) 141175.0 141260.0 141212.0 141008.0000 140541.000000
男性人口(万人) 72206.0 72311.0 72357.0 72039.0000 71863.871426
女性人口(万人) 68969.0 68949.0 68855.0 68969.0000 68677.128574
城镇人口(万人) 92071.0 91425.0 90220.0 88426.1168 86432.715000
乡村人口(万人) 49104.0 49835.0 50992.0 52581.8832 54108.285000
国家统计局地区数据
接口: macro_china_nbs_region
目标地址: https://data.stats.gov.cn/easyquery.htm
描述: 国家统计局地区数据通用接口，包括分省月度数据、分省季度数据、分省年度数据、主要城市月度价格、主要城市年度数据、港澳台月度数据、港澳台年度数据，具体指标见数据官网。
限量: 根据参数返回指定数据
输入参数
| 名称 | 类型 | 描述 |
|---|---|---|
| kind | str | 数据类别，包括：分省月度数据、分省季度数据、分省年度数据、主要城市月度价格、主要城市年度数据、港澳台月度数据、港澳台年度数据。 |
| path | str | 数据路径， 需与kind匹配，具体见官网，多层级之间使用 > 连接 。 示例： 国民经济核算 > 地区生产总值 财政 > 地方财政收入 |
| indicator | Union[str, None] | 指定指标，表示在当前path下可选择的指标。在指定region参数的情况下，此参数可以设置为None，此时将获取指定地区下所有可选指标的值。indicator和region参数不能同时为None。 |
| region | Union[str, None] | 指定地区，为可选指标。指定时表示仅获取当前地区下的数据。 |
| period | str | 时间区间 参考格式如下(英文逗号分割，且不能有多余空格)： 月：201201,201205 季：2012A,2012B,2012C,2012D 年：2012,2013 至今：2013- 最近：last10 |
输出参数
| 名称 | 类型 | 描述 |
|---|---|---|
| - | - | - |
接口示例
import meshare as ms
macro_china_nbs_region_df = ms.macro_china_nbs_region(kind="分省季度数据", path="国民经济核算 > 地区生产总值", period="last3", indicator=None, region="河北省")
print(macro_china_nbs_region_df)
macro_china_nbs_region_df = ms.macro_china_nbs_region(kind="分省季度数据", path="人民生活 > 居民人均可支配收入", indicator='居民人均可支配收入_累计值(元)', period="2022")
print(macro_china_nbs_region_df)
数据示例
region_gdp_df
河北省 2023年第二季度 2023年第一季度 2022年第四季度
地区生产总值_累计值(亿元) 20779.0 10041.0 42370.0
地区生产总值指数(上年同期=100)_累计值(%) 106.1 105.1 103.8
region_income_df
居民人均可支配收入_累计值(元) 2022年第四季度 2022年第三季度 2022年第二季度 2022年第一季度
北京市 77414.548842 58596.590041 39391.260057 20630.0
天津市 48976.122565 38934.695987 25453.536929 14082.0
河北省 30867.016699 22783.082852 14998.243977 7863.0
... ... ... ... ...
新疆维吾尔自治区 27062.738782 16553.955250 10747.883634 5713.0