~/public-data/usaspending-scraper

USAspending.gov Scraper — Dana Federal, Penerima & Agregat

Query API resmi USAspending.gov v2 untuk kontrak, hibah, dan pinjaman federal. Filter berdasarkan agency, penerima, NAICS/PSC, atau tanggal, dan tarik profil penerima, category total, serta agregat geografi state/county/district. Tanpa API key.

pemerintah TypeScriptREST API Amerika Serikat

run di Apify

proooxy/usaspending-scraper — spec

kategoripublic-data / pemerintah

bahasaTypeScript

stackTypeScript, REST API

pasarAmerika Serikat

outputJSON bersih, siap-RAG

fitur utama

API resmi USAspending.gov v2 — tanpa API key

Pencarian dana lintas keywords, fiscal year/rentang tanggal, agency, penerima, NAICS, PSC, jumlah, dan award type

Enam mode — award search, award detail, subawards, recipient profile, category totals, dan geography

18 dimensi category-aggregation (recipient, NAICS, PSC, agency, county, district, CFDA, TAS, dan lainnya)

Agregat geografi berdasarkan state, county, congressional district, dan country dengan field population dan per-capita

Date slicing otomatis (bulanan/kuartalan) untuk result set multi-tahun yang besar

Batching award-type-code otomatis menjadi grup request API yang valid

Lookup award-detail dan subaward yang presisi berdasarkan generated award ID

use case

Business development GovCon — menemukan peluang dan incumbent contractor berdasarkan NAICS, PSC, atau agency
Competitive intelligence atas riwayat dana kompetitor dan hubungan agency-nya
Jurnalisme investigatif yang menelusuri belanja federal ke penerima atau geografi tertentu
Riset kebijakan dan akademis atas tren belanja berdasarkan category, award type, atau periode waktu
Review due-diligence atas riwayat dana federal dan belanja seorang penerima
Dashboard BI yang memetakan belanja federal berdasarkan state, county, atau congressional district

parameter input

Parameter	Tipe	Wajib	Deskripsi
`mode`	string	opsional	Workflow: awards, awardDetail, subawards, recipient, byCategory, atau geography (default: awards).
`keywords`	array	opsional	Filter keyword free-text USAspending untuk award search.
`fiscalYear`	number	opsional	Fiscal year federal (memetakan ke rentang tanggal 1 Okt – 30 Sep).
`awardTypes`	array	opsional	Kode award type USAspending; grup campuran otomatis dipecah menjadi request yang valid.
`agency`	string	opsional	Filter nama awarding atau funding agency yang exact.
`naicsCodes`	array	opsional	Kode NAICS yang harus dicocokkan oleh sebuah award.
`awardId`	string	opsional	Generated award ID — wajib diisi saat runtime untuk mode awardDetail dan subawards.
`maxItems`	number	opsional	Jumlah maksimum record yang disimpan; setiap baris dihitung sebagai satu billed event (default: 100).

Contoh Output

 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}

Harga

Pay-per-event: $0.001 per record yang disimpan, dikenakan sekali per baris yang berhasil dikembalikan. Run ~1,000-record berharga sekitar ~$1.00, dan maxItems membatasi volume sekaligus biaya.

Tips

Mulai dengan kode NAICS atau PSC untuk prospecting GovCon — kode ini langsung memetakan ke produk/layanan yang Anda jual dan mengembalikan kumpulan dana yang paling relevan dan bersih.
Gunakan mode byCategory untuk me-ranking penerima atau agency teratas di sebuah pasar sebelum menarik detail dana individual.
Mode geography mengembalikan halaman pertama (hingga 100 baris) per kombinasi date-range/award-type — persempit filternya, jangan menaikkan maxItems, untuk roll-up state/county/district.

faq

Apakah saya perlu API key?

Tidak. API USAspending.gov v2 bersifat publik dan tidak memerlukan key atau login.

Mengapa kode award-type yang campuran dipecah menjadi beberapa request?

USAspending menolak satu search yang mencampur kode dari grup award-type berbeda (contracts, IDVs, grants, loans, other financial assistance, direct payments). Actor ini mengelompokkan kode yang diminta secara otomatis dan menandai setiap baris output dengan kode award type yang cocok.

Breakdown geografis apa saja yang tersedia?

State, county, congressional district, dan country — di-scope ke place of performance atau recipient location, lengkap dengan field population dan per-capita.

Bagaimana biaya sebuah run dihitung?

Pay-per-event sebesar $0.001 per baris yang disimpan, dikenakan sekali per record yang berhasil dikembalikan. maxItems membatasi jumlah baris dan karenanya juga biayanya.