~/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 등)
인구 및 1인당 필드를 포함한 주, 카운티, 연방 하원 선거구, 국가별 지리 집계
여러 해에 걸친 대규모 결과 집합에 대한 자동 날짜 분할(월별/분기별)
지급 유형 코드를 유효한 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}
요금
이벤트당 과금: 저장된 레코드 1건당 $0.001이며, 성공적으로 반환된 행마다 한 번씩 청구됩니다. 약 1,000건 실행은 약 $1.00이며, maxItems로 처리량과 비용을 모두 제한할 수 있습니다.
팁
- GovCon 잠재고객 발굴에는 NAICS나 PSC 코드를 우선 활용하세요 — 판매하는 상품/서비스에 직접 매핑되며 가장 깔끔한 관련 지급 내역 집합을 반환합니다.
- 개별 지급 상세를 가져오기 전에
byCategory모드를 사용해 시장의 상위 수혜자나 기관 순위를 먼저 파악하세요. - geography 모드는 기간/지급 유형 조합당 첫 페이지(최대 100행)만 반환합니다 — 주/카운티/선거구 롤업에는
maxItems를 올리기보다 필터를 좁히세요.
자주 묻는 질문
API 키가 필요한가요?
아니요. USAspending.gov API v2는 공개되어 있으며 키나 로그인이 필요 없습니다.
혼합된 지급 유형 코드는 왜 여러 요청으로 분할되나요?
USAspending은 서로 다른 지급 유형 그룹(계약, IDV, 보조금, 대출, 기타 재정 지원, 직접 지급)의 코드가 섞인 단일 검색을 거부합니다. 액터는 요청된 코드를 자동으로 그룹화하고, 각 출력 행에 일치하는 지급 유형 코드를 태그합니다.
어떤 지리적 분류를 이용할 수 있나요?
주, 카운티, 연방 하원 선거구, 국가 단위이며, 이행 장소 또는 수혜자 소재지 기준으로 범위가 지정되고, 인구 및 1인당 필드가 포함됩니다.
실행 비용은 어떻게 책정되나요?
저장된 행 1개당 $0.001의 이벤트당 과금이며, 성공적으로 반환된 레코드마다 한 번씩 청구됩니다. maxItems로 행 수와 비용을 제한할 수 있습니다.