~/public-data/usaspending-scraper

USAspending.gov Scraper — Concessões Federais, Beneficiários e Agregados

Consulte a API v2 oficial do USAspending.gov para contratos, subvenções e empréstimos federais. Filtre por agência, beneficiário, NAICS/PSC ou data, e obtenha perfis de beneficiários, totais por categoria e agregados geográficos por estado/condado/distrito. Sem chave de API.

governo TypeScriptREST API Estados Unidos

executar no Apify

proooxy/usaspending-scraper — especificações

categoriapublic-data / governo

linguagemTypeScript

stackTypeScript, REST API

mercadosEstados Unidos

saídaJSON limpo e pronto para RAG

principais recursos

API v2 oficial do USAspending.gov — sem necessidade de chave de API

Busca de concessões por palavras-chave, ano fiscal/intervalo de data, agência, beneficiário, NAICS, PSC, valor e tipo de concessão

Seis modos — busca de concessões, detalhe de concessão, subconcessões, perfil de beneficiário, totais por categoria e geografia

18 dimensões de agregação por categoria (beneficiário, NAICS, PSC, agência, condado, distrito, CFDA, TAS e mais)

Agregados geográficos por estado, condado, distrito congressional e país, com campos de população e per capita

Fatiamento automático de data (mensal/trimestral) para grandes conjuntos de resultados multi-anuais

Agrupamento automático de códigos de tipo de concessão em grupos de requisição válidos para a API

Busca exata de detalhe de concessão e subconcessão pelo ID de concessão gerado

casos de uso

Desenvolvimento de negócios GovCon — encontre oportunidades e contratados incumbentes por NAICS, PSC ou agência
Inteligência competitiva sobre o histórico de concessões e relacionamentos com agências de um concorrente
Jornalismo investigativo rastreando gastos federais até beneficiários ou geografias específicas
Pesquisa de políticas públicas e acadêmica sobre tendências de gastos por categoria, tipo de concessão ou período
Revisão de due diligence do histórico de concessões e gastos federais de um beneficiário
Dashboards de BI mapeando gastos federais por estado, condado ou distrito congressional

parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Descrição
`mode`	string	opcional	Fluxo: awards, awardDetail, subawards, recipient, byCategory ou geography (padrão: awards).
`keywords`	array	opcional	Filtros de palavra-chave em texto livre do USAspending para busca de concessões.
`fiscalYear`	number	opcional	Ano fiscal federal (corresponde ao intervalo de 1º de outubro a 30 de setembro).
`awardTypes`	array	opcional	Códigos de tipo de concessão do USAspending; grupos mistos são divididos automaticamente em requisições válidas.
`agency`	string	opcional	Filtro por nome exato da agência concedente ou financiadora.
`naicsCodes`	array	opcional	Códigos NAICS que uma concessão deve corresponder.
`awardId`	string	opcional	ID de concessão gerado — obrigatório em tempo de execução para os modos awardDetail e subawards.
`maxItems`	number	opcional	Máximo de registros salvos; cada linha é um evento cobrado (padrão: 100).

Exemplo de Saída

 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}

Preços

Pagamento por evento: $0.001 por registro salvo, cobrado uma vez por linha retornada com sucesso. Uma execução de ~1,000 registros é ~$1.00, e maxItems limita tanto o volume quanto o custo.

Dicas

Comece pelos códigos NAICS ou PSC para prospecção GovCon — eles mapeiam diretamente para os produtos/serviços que você vende e retornam o conjunto mais limpo de concessões relevantes.
Use o modo byCategory para classificar os principais beneficiários ou agências de um mercado antes de buscar o detalhe de concessões individuais.
O modo geography retorna a primeira página (até 100 linhas) por combinação de intervalo de data/tipo de concessão — refine os filtros em vez de aumentar maxItems para totalizações por estado/condado/distrito.

faq

Preciso de uma chave de API?

Não. A API v2 do USAspending.gov é pública e não exige chave nem login.

Por que códigos mistos de tipo de concessão são divididos em múltiplas requisições?

O USAspending rejeita uma única busca que misture códigos de diferentes grupos de tipo de concessão (contratos, IDVs, subvenções, empréstimos, outras assistências financeiras, pagamentos diretos). O ator agrupa os códigos solicitados automaticamente e marca cada linha de saída com os códigos de tipo de concessão correspondentes.

Quais desagregações geográficas estão disponíveis?

Estado, condado, distrito congressional e país — delimitados pelo local de execução ou pela localização do beneficiário, com campos de população e per capita incluídos.

Como uma execução é precificada?

Pagamento por evento, a $0.001 por linha salva, cobrado uma vez por registro retornado com sucesso. maxItems limita o número de linhas e, portanto, o custo.