~/public-data/usaspending-scraper

USAspending.gov Scraper — Bundesvergaben, Empfänger & Aggregate

Die offizielle USAspending.gov-API v2 nach Bundesverträgen, -zuschüssen und -darlehen durchsuchen. Filterbar nach Behörde, Empfänger, NAICS/PSC oder Datum; Empfängerprofile, Kategorie-Summen und geografische Aggregate nach Bundesstaat/County/Distrikt abrufen. Kein API-Key.

Behörden TypeScriptREST API USA

auf Apify ausführen

proooxy/usaspending-scraper — Steckbrief

Kategoriepublic-data / Behörden

SpracheTypeScript

StackTypeScript, REST API

MärkteUSA

Outputsauberes, RAG-fertiges JSON

Hauptfunktionen

Offizielle USAspending.gov-API v2 — kein API-Key erforderlich

Vergabe-Suche über Keywords, Geschäftsjahr/Datumsbereich, Behörde, Empfänger, NAICS, PSC, Betrag und Vergabetyp

Sechs Modi — Vergabe-Suche, Vergabe-Detail, Sub-Vergaben, Empfängerprofil, Kategorie-Summen und Geografie

18 Kategorie-Aggregationsdimensionen (Empfänger, NAICS, PSC, Behörde, County, Distrikt, CFDA, TAS und mehr)

Geografische Aggregate nach Bundesstaat, County, Kongress-Distrikt und Land, mit Bevölkerungs- und Pro-Kopf-Feldern

Automatische Datums-Segmentierung (monatlich/quartalsweise) für große Mehrjahres-Ergebnismengen

Automatisches Batching von Vergabetyp-Codes in gültige API-Anfragegruppen

Exakte Vergabe-Detail- und Sub-Vergabe-Abfrage per generierter Award-ID

Anwendungsfälle

GovCon-Geschäftsentwicklung — Opportunities und aktuelle Auftragnehmer nach NAICS, PSC oder Behörde finden
Wettbewerbsanalyse zur Vergabehistorie und den Behördenbeziehungen eines Wettbewerbers
Investigativer Journalismus, der Bundesausgaben zu bestimmten Empfängern oder Regionen zurückverfolgt
Politik- und akademische Forschung zu Ausgabentrends nach Kategorie, Vergabetyp oder Zeitraum
Due-Diligence-Prüfung der Vergabe- und Ausgabenhistorie eines Empfängers
BI-Dashboards, die Bundesausgaben nach Bundesstaat, County oder Kongress-Distrikt abbilden

Eingabeparameter

Parameter	Typ	Erforderlich	Beschreibung
`mode`	string	optional	Workflow: awards, awardDetail, subawards, recipient, byCategory oder geography (Standard: awards).
`keywords`	array	optional	Freitext-Keyword-Filter von USAspending für die Vergabe-Suche.
`fiscalYear`	number	optional	Föderales Geschäftsjahr (entspricht dem Zeitraum 1. Okt. – 30. Sep.).
`awardTypes`	array	optional	USAspending-Vergabetyp-Codes; gemischte Gruppen werden automatisch in gültige Anfragen aufgeteilt.
`agency`	string	optional	Exakter Filter nach vergebender oder finanzierender Behörde.
`naicsCodes`	array	optional	NAICS-Codes, denen eine Vergabe entsprechen muss.
`awardId`	string	optional	Generierte Award-ID — zur Laufzeit erforderlich für die Modi awardDetail und subawards.
`maxItems`	number	optional	Maximal gespeicherte Datensätze; jede Zeile ist ein abgerechnetes Event (Standard: 100).

Beispiel-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}

Preise

Pay-per-Event: $0.001 pro gespeichertem Datensatz, abgerechnet einmal pro erfolgreich zurückgegebener Zeile. Ein Run mit ~1.000 Datensätzen kostet ~$1.00, maxItems begrenzt sowohl Menge als auch Kosten.

Tipps

Mit NAICS- oder PSC-Codes einsteigen für GovCon-Prospecting — sie bilden die verkauften Produkte/Dienstleistungen direkt ab und liefern die sauberste Menge relevanter Vergaben.
Den Modus byCategory nutzen, um die Top-Empfänger oder -Behörden für einen Markt zu ranken, bevor einzelne Vergabe-Details abgerufen werden.
Der Modus geography liefert die erste Seite (bis zu 100 Zeilen) pro Kombination aus Datumsbereich/Vergabetyp — für Roll-ups nach Bundesstaat/County/Distrikt lieber die Filter verengen als maxItems zu erhöhen.

FAQ

Brauche ich einen API-Key?

Nein. Die USAspending.gov-API v2 ist öffentlich und benötigt weder Key noch Login.

Warum werden gemischte Vergabetyp-Codes auf mehrere Anfragen aufgeteilt?

USAspending lehnt eine einzelne Suche ab, die Codes aus unterschiedlichen Vergabetyp-Gruppen mischt (Contracts, IDVs, Grants, Loans, Other Financial Assistance, Direct Payments). Der Actor gruppiert die angeforderten Codes automatisch und taggt jede Output-Zeile mit den passenden Vergabetyp-Codes.

Welche geografischen Aufschlüsselungen sind verfügbar?

Bundesstaat, County, Kongress-Distrikt und Land — bezogen entweder auf den Leistungsort oder den Empfängerstandort, jeweils inklusive Bevölkerungs- und Pro-Kopf-Feldern.

Wie wird ein Run abgerechnet?

Pay-per-Event zu $0.001 pro gespeicherter Zeile, abgerechnet einmal pro erfolgreich zurückgegebenem Datensatz. maxItems begrenzt die Anzahl der Zeilen und damit die Kosten.