~/public-data/usaspending-scraper
USAspending.gov Scraper——联邦支出项目、接收方与汇总数据
查询官方 USAspending.gov API v2 的联邦合同、拨款与贷款数据。支持按机构、接收方、NAICS/PSC 或日期筛选,并可拉取接收方档案、分类汇总,以及州/县/选区的地理汇总数据。无需 API 密钥。
政府
TypeScriptREST API
美国
分类public-data / 政府
语言TypeScript
技术栈TypeScript, REST API
市场美国
输出干净、RAG 就绪的 JSON
核心特性
官方 USAspending.gov API v2——无需 API 密钥
支持按关键词、财年/日期区间、机构、接收方、NAICS、PSC、金额与支出类型检索支出项目
六种模式——支出项目检索、支出项目详情、转授项目、接收方档案、分类汇总与地理分布
18 个分类汇总维度(接收方、NAICS、PSC、机构、县、选区、CFDA、TAS 等)
按州、县、国会选区与国家汇总地理数据,并附带人口与人均字段
对跨年度的大型结果集自动按月/季度切片
自动将支出类型代码分批组合为合法的 API 请求分组
支持按生成的项目 ID 精确查询支出项目详情与转授项目
应用场景
- GovCon(政府采购)业务拓展——按 NAICS、PSC 或机构寻找商机与在位承包商
- 针对竞争对手中标历史与机构关系的竞争情报
- 追踪联邦支出流向特定接收方或地区的调查性新闻报道
- 按类别、支出类型或时间段研究支出趋势的政策与学术研究
- 对某接收方联邦支出与获授历史的尽职调查
- 按州、县或国会选区绘制联邦支出分布的 BI 仪表盘
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
mode | string | 可选 | 工作流:awards、awardDetail、subawards、recipient、byCategory 或 geography(默认:awards)。 |
keywords | array | 可选 | 用于支出项目检索的 USAspending 自由文本关键词筛选。 |
fiscalYear | number | 可选 | 联邦财年(对应 10 月 1 日至次年 9 月 30 日的日期区间)。 |
awardTypes | array | 可选 | USAspending 的支出类型代码;混合的类型分组会被自动拆分为合法请求。 |
agency | string | 可选 | 精确匹配的授予机构或出资机构名称筛选。 |
naicsCodes | array | 可选 | 支出项目必须匹配的 NAICS 代码。 |
awardId | string | 可选 | 生成的项目 ID——awardDetail 与 subawards 模式下运行时为必填。 |
maxItems | number | 可选 | 最多保存的记录数;每行计为一次计费事件(默认:100)。 |
输出示例
1{
2 "itemType": "award",
3 "title": "HT940216C0001 — HUMANA GOVERNMENT BUSINESS INC",
4 "date": "2016-02-01",
5 "awardId": "HT940216C0001",
6 "generatedId": "CONT_AWD_HT940216C0001_9700_-NONE-_-NONE-",
7 "recipient": { "name": "HUMANA GOVERNMENT BUSINESS INC", "uei": "...", "duns": "..." },
8 "awardingAgency": "Department of Defense",
9 "fundingAgency": "Department of Defense",
10 "amount": 51269205263.03,
11 "awardType": "IDV_B_C",
12 "naics": { "code": "...", "description": "..." },
13 "placeOfPerformance": { "stateCode": "...", "state": "..." },
14 "awardTypeCodes": ["IDV_B_C"],
15 "url": "https://www.usaspending.gov/award/CONT_AWD_HT940216C0001_9700_-NONE-_-NONE-"
16}
价格
按事件计费:每保存一条记录收费 $0.001,每条成功返回的记录只收费一次。约 1,000 条记录的运行费用约为 $1.00,maxItems 可同时限制数量与费用上限。
使用建议
- GovCon 商机挖掘优先使用 NAICS 或 PSC 代码——它们直接对应你所销售的产品/服务,能返回最干净、最相关的支出项目集合。
- 在拉取单个支出项目详情之前,先用
byCategory模式为某个市场的头部接收方或机构排名。 - geography 模式每个日期区间/支出类型组合只返回首页(最多 100 行)——做州/县/选区汇总时,应收紧筛选条件,而不是一味调高
maxItems。
常见问题
我需要 API 密钥吗?
不需要。USAspending.gov API v2 是公开的,无需密钥或登录。
为什么混合的支出类型代码会被拆分成多个请求?
USAspending 不接受在同一次检索中混用不同支出类型分组(合同、IDV、拨款、贷款、其他财政援助、直接支付)的代码。该 Actor 会自动对请求的代码分组,并为每一行输出结果标注匹配到的支出类型代码。
支持哪些地理维度的拆分?
州、县、国会选区与国家——可按履约地点或接收方所在地划分,并包含人口与人均字段。
运行如何计费?
按事件计费,每保存一行收费 $0.001,每条成功返回的记录只收费一次。maxItems 可限制记录行数,从而控制费用。