~/public-data/usaspending-scraper

USAspending.gov Scraper — федеральные контракты, получатели и агрегированные данные

Запрашивайте в официальном API USAspending.gov v2 федеральные контракты, гранты и займы. Фильтруйте по агентству, получателю, NAICS/PSC или дате и выгружайте профили получателей, итоги по категориям и геоагрегаты по штатам, округам и избирательным округам. Без API-ключа.

государственный сектор TypeScriptREST API США
proooxy/usaspending-scraper — характеристики
категорияpublic-data / государственный сектор
языкTypeScript
стекTypeScript, REST API
рынкиСША
выводчистый JSON, готовый к RAG

ключевые возможности

Официальный API USAspending.gov v2 — без API-ключа

Поиск контрактов по ключевым словам, финансовому году/диапазону дат, агентству, получателю, NAICS, PSC, сумме и типу контракта

Шесть режимов — поиск контрактов, детали контракта, субконтракты, профиль получателя, итоги по категориям и география

18 измерений агрегации по категориям (получатель, NAICS, PSC, агентство, округ, избирательный округ, CFDA, TAS и другие)

Геоагрегаты по штатам, округам, избирательным округам Конгресса и странам с полями населения и показателей на душу населения

Автоматическое разбиение по датам (по месяцам/кварталам) для больших многолетних наборов результатов

Автоматическая группировка кодов типов контрактов в допустимые группы запросов API

Точный поиск деталей контракта и субконтрактов по сгенерированному ID контракта

сценарии использования

  • Развитие бизнеса в сфере государственных контрактов — поиск возможностей и действующих подрядчиков по NAICS, PSC или агентству
  • Конкурентная аналитика по истории контрактов конкурента и его связям с агентствами
  • Журналистские расследования, отслеживающие федеральные расходы до конкретных получателей или территорий
  • Политические и академические исследования трендов расходов по категориям, типам контрактов или периодам
  • Due diligence-проверка истории федеральных контрактов и расходов получателя
  • BI-дашборды с картированием федеральных расходов по штатам, округам или избирательным округам

входные параметры

ПараметрТипОбязательныйОписание
modestringопциональноРабочий режим: awards, awardDetail, subawards, recipient, byCategory или geography (по умолчанию: awards).
keywordsarrayопциональноПроизвольные текстовые фильтры по ключевым словам USAspending для поиска контрактов.
fiscalYearnumberопциональноФедеральный финансовый год (соответствует диапазону дат с 1 октября по 30 сентября).
awardTypesarrayопциональноКоды типов контрактов USAspending; смешанные группы автоматически разбиваются на допустимые запросы.
agencystringопциональноФильтр по точному названию агентства-заказчика или агентства-плательщика.
naicsCodesarrayопциональноКоды NAICS, которым должен соответствовать контракт.
awardIdstringопциональноСгенерированный ID контракта — обязателен во время выполнения для режимов awardDetail и subawards.
maxItemsnumberопциональноМаксимум сохраняемых записей; каждая строка — одно тарифицируемое событие (по умолчанию: 100).

Пример вывода

 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}

Цена

Оплата за событие: $0.001 за сохраненную запись, взимается один раз за каждую успешно возвращенную строку. Запуск на ~1000 записей — это ~$1.00, а maxItems ограничивает и объем, и стоимость.

Советы

  • Начинайте с кодов NAICS или PSC для поиска возможностей в сфере госконтрактов — они напрямую соответствуют продуктам/услугам, которые вы продаете, и возвращают самый чистый набор релевантных контрактов.
  • Используйте режим byCategory, чтобы ранжировать топ получателей или агентств на рынке, прежде чем выгружать детали отдельных контрактов.
  • Режим geography возвращает только первую страницу (до 100 строк) на каждую комбинацию диапазона дат/типа контракта — сужайте фильтры вместо повышения maxItems для сводок по штатам/округам/избирательным округам.

частые вопросы

Нужен ли мне API-ключ?
Нет. API v2 USAspending.gov публичный и не требует ни ключа, ни входа.
Почему смешанные коды типов контрактов разбиваются на несколько запросов?
USAspending отклоняет единый поисковый запрос, смешивающий коды из разных групп типов контрактов (contracts, IDVs, grants, loans, other financial assistance, direct payments). Актор автоматически группирует запрошенные коды и помечает каждую строку вывода соответствующими кодами типа контракта.
Какие географические разбивки доступны?
Штат, округ, избирательный округ Конгресса и страна — с привязкой либо к месту исполнения контракта, либо к местоположению получателя, с полями населения и показателей на душу населения.
Как тарифицируется запуск?
Оплата за событие — $0.001 за сохраненную строку, взимается один раз за каждую успешно возвращенную запись. maxItems ограничивает число строк и, соответственно, стоимость.

похожие в ~/public-data

Запустите USAspending.gov Scraper — федеральные контракты, получатели и агрегированные данные или закажите разработку под задачу

Начните извлекать данные на Apify за считаные минуты или закажите у меня разработку парсера на заказ и RAG-конвейера под ваш источник и схему.

запустить на Apify заказать данные