US Census
美国人口普查局（US Census Bureau）开展的美国社区调查（ACS）是一项关于美国人口、收入和住房的年度调查。通过 ScholarMuse，agent 可以用 find_series 从 8 项常用的 ACS 一年期指标里挑选，也可以用 get_series 取任意 ACS 一年期明细表变量，得到全美或单个州的年度序列。
对应的 ScholarMuse 工具：find_series、get_series。每次成功调用都会扣积分。
可以这样问你的 agent
你的 agent 会拿到什么
每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 US Census 的数据字段。
find_series
搜索的是连接器内置的 8 个 ACS 一年期变量，而不是人口普查局的完整目录。查询里提到美国以外的国家时，会跳过 Census。
- seriesId
- 如 census:acs1/B19013_001E
- title
- 内置清单中的指标名称
- frequency
- 固定为 Annual
- units
- 单位，如 Persons 或 US dollars per month
- geography
- United States，并提示如何加州代码
- coverageStart
- 最早的调查年份，即 2005
get_series
不在内置清单里的变量，标题只是变量代码，也没有 units。
- seriesId
- 变量编号，查询州时带 ?state=NN
- title
- 指标名称（仅限清单内的变量）
- units
- 单位（仅限清单内的变量）
- frequency
- 年度
- geography
- Census API 返回的地区名称，如 United States 或 California
- start
- 返回的首个调查年份
- end
- 返回的最后调查年份
- count
- 返回的年份个数
- observations
- 年份与数值组成的列表
覆盖范围
- 只有美国社区调查（ACS）一年期估计值，从 2005 调查年到人口普查局已发布的最新年份（2026 年 10 月 13 日核对时为 2024 年）。
- find_series 内置 8 项指标：总人口、年龄中位数、家庭收入中位数、人均收入、贫困线以下人口、租金中位数、自有住房价值中位数和住房单元总数。
- 地理范围是全美，或者加上 ?state= 和两位 FIPS 代码后的单个州，例如 ?state=06 表示加利福尼亚州。
- get_series 也接受其他 ACS 一年期明细表变量，写作 acs1/<变量>，例如 acs1/B08303_001E。调查后来才加入的变量，从它出现的第一年开始。
限制
- 不包含十年一次的人口普查、ACS 五年期、人口估计和经济普查数据，也不能查县、市、普查区和都会区。
- 2020 年始终缺失，因为人口普查局当年没有发布标准的 ACS 一年期估计值。
- 只返回估计值，不含误差范围；人口普查局标为不可用的数值会被去掉。
- 金额以各调查年份当年的美元计，不同年份之间没有做通胀调整。
ScholarMuse 怎么访问 US Census
连接器直接调用 Census Bureau Data API，每个调查年份向 /data/{year}/acs/acs1 发一次请求，使用 ScholarMuse 自己的 Census API key。Census API 已不再响应不带 key 的请求，所以没有配置 key 时，get_series 对这个来源会报错。
每个年份的响应最多缓存 30 天，修订后的估计值可能要这么久才会出现。
API key：上游 API 需要 key，ScholarMuse 用自己的 key，你不用申请。
许可与署名
许可：Public domain (US Government work)
Source: US Census Bureau (census.gov). This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.
来自 US Census 的记录都带这段许可和署名。 在论文里引用时，请按 US Census 自己的引用要求来写。
