~/public-data/usaspending-scraper

Scraper de USAspending.gov — Adjudicaciones federales, beneficiarios y agregados

Consulta la API v2 oficial de USAspending.gov para contratos, subvenciones y préstamos federales. Filtra por agencia, beneficiario, NAICS/PSC o fecha, y obtén perfiles de beneficiarios, totales por categoría y agregados geográficos por estado/condado/distrito. Sin clave API.

gobierno TypeScriptREST API Estados Unidos

ejecutar en Apify

proooxy/usaspending-scraper — spec

categoríapublic-data / gobierno

lenguajeTypeScript

stackTypeScript, REST API

mercadosEstados Unidos

salidaJSON limpio y listo para RAG

características clave

API v2 oficial de USAspending.gov — no requiere clave API

Búsqueda de adjudicaciones por palabras clave, año fiscal/rango de fechas, agencia, beneficiario, NAICS, PSC, importe y tipo de adjudicación

Seis modos — búsqueda de adjudicaciones, detalle de adjudicación, subadjudicaciones, perfil de beneficiario, totales por categoría y geografía

18 dimensiones de agregación por categoría (beneficiario, NAICS, PSC, agencia, condado, distrito, CFDA, TAS y más)

Agregados geográficos por estado, condado, distrito congresional y país, con campos de población y per cápita

Fragmentación automática de fechas (mensual/trimestral) para conjuntos de resultados grandes de varios años

Agrupación automática de códigos de tipo de adjudicación en lotes de solicitudes de API válidos

Búsqueda exacta de detalle de adjudicación y subadjudicación por ID de adjudicación generado

casos de uso

Desarrollo de negocio GovCon — encuentra oportunidades y contratistas incumbentes por NAICS, PSC o agencia
Inteligencia competitiva sobre el historial de adjudicaciones y las relaciones con agencias de un competidor
Periodismo de investigación que rastrea el gasto federal hasta beneficiarios o áreas geográficas concretas
Investigación de políticas públicas y académica sobre tendencias de gasto por categoría, tipo de adjudicación o periodo
Revisión de due diligence del historial de adjudicaciones y gasto federal de un beneficiario
Dashboards de BI que mapean el gasto federal por estado, condado o distrito congresional

parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`mode`	string	opcional	Flujo de trabajo: awards, awardDetail, subawards, recipient, byCategory o geography (por defecto: awards).
`keywords`	array	opcional	Filtros de palabras clave de texto libre de USAspending para la búsqueda de adjudicaciones.
`fiscalYear`	number	opcional	Año fiscal federal (corresponde al rango del 1 de octubre al 30 de septiembre).
`awardTypes`	array	opcional	Códigos de tipo de adjudicación de USAspending; los grupos mixtos se dividen automáticamente en solicitudes válidas.
`agency`	string	opcional	Filtro de nombre exacto de la agencia otorgante o financiadora.
`naicsCodes`	array	opcional	Códigos NAICS que debe coincidir una adjudicación.
`awardId`	string	opcional	ID de adjudicación generado — obligatorio en tiempo de ejecución para los modos awardDetail y subawards.
`maxItems`	number	opcional	Máximo de registros guardados; cada fila equivale a un evento facturable (por defecto: 100).

Ejemplo de salida

 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}

Precios

Pago por evento: $0.001 por registro guardado, cobrado una vez por cada fila devuelta con éxito. Una ejecución de ~1,000 registros cuesta ~$1.00, y maxItems limita tanto el volumen como el coste.

Consejos

Empieza por códigos NAICS o PSC para la prospección GovCon — se corresponden directamente con los productos/servicios que vendes y devuelven el conjunto más limpio de adjudicaciones relevantes.
Usa el modo byCategory para clasificar los principales beneficiarios o agencias de un mercado antes de obtener el detalle de adjudicaciones individuales.
El modo geography devuelve la primera página (hasta 100 filas) por cada combinación de rango de fechas/tipo de adjudicación — reduce los filtros en lugar de aumentar maxItems para las agregaciones por estado/condado/distrito.

faq

¿Necesito una clave API?

No. La API v2 de USAspending.gov es pública y no requiere clave ni login.

¿Por qué los códigos de tipo de adjudicación mixtos se dividen en varias solicitudes?

USAspending rechaza una única búsqueda que mezcle códigos de diferentes grupos de tipo de adjudicación (contratos, IDVs, subvenciones, préstamos, otra asistencia financiera, pagos directos). El actor agrupa automáticamente los códigos solicitados y etiqueta cada fila de salida con los códigos de tipo de adjudicación coincidentes.

¿Qué desgloses geográficos están disponibles?

Estado, condado, distrito congresional y país — con alcance al lugar de ejecución o a la ubicación del beneficiario, incluyendo campos de población y per cápita.

¿Cómo se cobra una ejecución?

Pago por evento a $0.001 por fila guardada, cobrado una vez por cada registro devuelto con éxito. maxItems limita el número de filas y, por tanto, el coste.