~/public-data/usaspending-scraper

USAspending.gov Scraper — Financements fédéraux, bénéficiaires et agrégats

Interrogez l’API officielle USAspending.gov v2 pour contrats, subventions et prêts fédéraux. Filtrez par agence, bénéficiaire, NAICS/PSC ou date, et extrayez profils de bénéficiaires, totaux par catégorie, et agrégats géographiques état/comté/circonscription. Sans clé API.

administration publique TypeScriptREST API États-Unis

exécuter sur Apify

proooxy/usaspending-scraper — specs

catégoriepublic-data / administration publique

langageTypeScript

stackTypeScript, REST API

marchésÉtats-Unis

sortieJSON propre, prêt pour le RAG

fonctionnalités clés

API officielle USAspending.gov v2 — aucune clé API requise

Recherche de financements par mots-clés, année fiscale/plage de dates, agence, bénéficiaire, NAICS, PSC, montant et type de financement

Six modes — recherche de financements, détail de financement, sous-financements, profil bénéficiaire, totaux par catégorie, et géographie

18 dimensions d’agrégation par catégorie (bénéficiaire, NAICS, PSC, agence, comté, circonscription, CFDA, TAS, et plus)

Agrégats géographiques par état, comté, circonscription électorale et pays, avec champs de population et par habitant

Découpage automatique par date (mensuel/trimestriel) pour les grands jeux de résultats pluriannuels

Regroupement automatique des codes de type de financement en groupes de requêtes API valides

Recherche exacte de détail de financement et sous-financement par ID de financement généré

cas d’usage

Développement commercial GovCon — trouvez des opportunités et les titulaires de contrats en place par NAICS, PSC, ou agence
Veille concurrentielle sur l’historique de financements d’un concurrent et ses relations avec les agences
Journalisme d’investigation retraçant les dépenses fédérales vers des bénéficiaires ou zones géographiques spécifiques
Recherche politique et académique sur les tendances de dépenses par catégorie, type de financement, ou période
Revue de due diligence de l’historique de financements fédéraux et de dépenses d’un bénéficiaire
Tableaux de bord BI cartographiant les dépenses fédérales par état, comté, ou circonscription électorale

paramètres d’entrée

Paramètre	Type	Requis	Description
`mode`	string	optionnel	Workflow : awards, awardDetail, subawards, recipient, byCategory, ou geography (par défaut : awards).
`keywords`	array	optionnel	Filtres par mots-clés libres USAspending pour la recherche de financements.
`fiscalYear`	number	optionnel	Année fiscale fédérale (correspond à la plage du 1er oct. au 30 sept.).
`awardTypes`	array	optionnel	Codes de type de financement USAspending ; les groupes mixtes sont automatiquement répartis en requêtes valides.
`agency`	string	optionnel	Filtre exact par nom d’agence attributaire ou finançeuse.
`naicsCodes`	array	optionnel	Codes NAICS qu’un financement doit respecter.
`awardId`	string	optionnel	ID de financement généré — requis à l’exécution pour les modes awardDetail et subawards.
`maxItems`	number	optionnel	Nombre maximal d’enregistrements sauvegardés ; chaque ligne correspond à un événement facturé (par défaut : 100).

Exemple de sortie

 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}

Tarification

Facturation à l’événement : $0.001 par enregistrement sauvegardé, facturé une fois par ligne renvoyée avec succès. Un run d’environ 1 000 enregistrements coûte environ $1.00, et maxItems plafonne à la fois le volume et le coût.

Astuces

Commencez par les codes NAICS ou PSC pour la prospection GovCon — ils correspondent directement aux produits/services que vous vendez et renvoient l’ensemble le plus propre de financements pertinents.
Utilisez le mode byCategory pour classer les principaux bénéficiaires ou agences d’un marché avant d’extraire le détail de financements individuels.
Le mode geography renvoie la première page (jusqu’à 100 lignes) par combinaison plage de dates/type de financement — affinez les filtres plutôt que d’augmenter maxItems pour les agrégats état/comté/circonscription.

faq

Ai-je besoin d’une clé API ?

Non. L’API v2 de USAspending.gov est publique et ne nécessite ni clé ni connexion.

Pourquoi les codes de type de financement mixtes sont-ils répartis en plusieurs requêtes ?

USAspending rejette une recherche unique qui mélange des codes de groupes de types de financement différents (contrats, IDV, subventions, prêts, autre aide financière, paiements directs). L’acteur regroupe automatiquement les codes demandés et associe à chaque ligne de sortie les codes de type de financement correspondants.

Quelles répartitions géographiques sont disponibles ?

État, comté, circonscription électorale et pays — selon le lieu d’exécution ou la localisation du bénéficiaire, avec des champs de population et par habitant inclus.

Comment un run est-il facturé ?

Facturation à l’événement, à $0.001 par ligne sauvegardée, facturée une fois par enregistrement renvoyé avec succès. maxItems plafonne le nombre de lignes, et donc le coût.