~/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、金額、案件タイプを横断した案件検索
6つのモード — 案件検索、案件詳細、サブアワード、受給者プロフィール、カテゴリ別集計、地理集計
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 | 任意 | 保存するレコードの最大数。1行ごとに1課金イベント（デフォルト：100）。 |
Output Example
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}
Pricing
イベント課金制：保存されたレコード1件につき$0.001。正常に返された行1件につき1回課金されます。約1,000件の実行で約$1.00、maxItemsが件数とコストの両方に上限を設けます。
Tips
- GovConの見込み客開拓には、まずNAICSまたはPSCコードから始めましょう。 自社が提供する製品/サービスに直結し、最も的確な関連案件のセットが得られます。
- 個別の案件詳細を取得する前に
byCategoryモードを使いましょう。 市場ごとの上位受給者や省庁をランキング形式で把握できます。 - geographyモードは、日付範囲/案件タイプの組み合わせごとに最初のページ（最大100行）を返します。 州/郡/選挙区の集計を得るには、
maxItemsを上げるよりもフィルタを絞り込みましょう。
よくある質問
APIキーは必要ですか？
いいえ。USAspending.gov API v2は公開されており、キーもログインも不要です。
異なる案件タイプコードが混在すると、なぜ複数のリクエストに分割されるのですか？
USAspendingは、異なる案件タイプグループ（contracts、IDVs、grants、loans、other financial assistance、direct payments）のコードが混在した単一の検索を拒否します。このアクターはリクエストされたコードを自動的にグループ化し、各出力行に一致した案件タイプコードをタグ付けします。
どのような地理的な内訳が取得できますか？
州、郡、連邦議会選挙区、国です——履行地または受給者所在地のいずれかを基準とし、人口と一人当たりの数値フィールドも含まれます。
実行の料金はどう決まりますか？
イベント課金制で、保存された行1件につき$0.001。正常に返されたレコード1件につき1回課金されます。maxItemsが行数、ひいてはコストの上限を決めます。