~/public-data/usaspending-scraper

USAspending.gov Scraper — फ़ेडरल अवार्ड्स, प्राप्तकर्ता और एग्रीगेट्स

फ़ेडरल contracts, grants, और loans के लिए आधिकारिक USAspending.gov API v2 को क्वेरी करें। agency, recipient, NAICS/PSC, या date से फ़िल्टर करें, और recipient प्रोफ़ाइल, category totals, और state/county/district geography aggregates खींचें। कोई API key नहीं।

सरकारी TypeScriptREST API संयुक्त राज्य अमेरिका

Apify पर रन करें

proooxy/usaspending-scraper — स्पेक

कैटेगरीpublic-data / सरकारी

भाषाTypeScript

स्टैकTypeScript, REST API

मार्केट्ससंयुक्त राज्य अमेरिका

आउटपुटसाफ, RAG-तैयार JSON

मुख्य विशेषताएं

आधिकारिक USAspending.gov API v2 — किसी API key की ज़रूरत नहीं

keywords, fiscal year/date रेंज, agency, recipient, NAICS, PSC, amount, और award type में award सर्च

छह मोड — award search, award detail, subawards, recipient profile, category totals, और geography

18 category-aggregation dimensions (recipient, NAICS, PSC, agency, county, district, CFDA, TAS, और भी बहुत कुछ)

population और per-capita फ़ील्ड के साथ state, county, congressional district, और country के हिसाब से geography aggregates

बड़े multi-year result sets के लिए ऑटोमैटिक date slicing (monthly/quarterly)

valid API रिक्वेस्ट ग्रुप में ऑटोमैटिक award-type-code बैचिंग

जनरेट किए गए award ID से सटीक award-detail और subaward लुकअप

यूज़ केस

GovCon बिज़नेस डेवलपमेंट — NAICS, PSC, या agency के हिसाब से opportunities और incumbent contractors ढूंढें
किसी कॉम्पिटिटर की award हिस्ट्री और agency संबंधों पर प्रतिस्पर्धी इंटेलिजेंस
खास प्राप्तकर्ताओं या geographies तक फ़ेडरल स्पेंडिंग ट्रेस करने वाली इन्वेस्टिगेटिव जर्नलिज़्म
category, award type, या time period के हिसाब से स्पेंडिंग ट्रेंड पर पॉलिसी और एकेडमिक रिसर्च
किसी प्राप्तकर्ता की फ़ेडरल award और स्पेंडिंग हिस्ट्री का due-diligence रिव्यू
state, county, या congressional district के हिसाब से फ़ेडरल spend मैप करने वाले BI डैशबोर्ड

इनपुट पैरामीटर

पैरामीटर	टाइप	आवश्यक	विवरण
`mode`	string	वैकल्पिक	वर्कफ़्लो: awards, awardDetail, subawards, recipient, byCategory, या geography (डिफ़ॉल्ट: awards)।
`keywords`	array	वैकल्पिक	award सर्च के लिए फ्री-टेक्स्ट USAspending keyword फ़िल्टर।
`fiscalYear`	number	वैकल्पिक	फ़ेडरल fiscal year (Oct 1 – Sep 30 date रेंज पर मैप होता है)।
`awardTypes`	array	वैकल्पिक	USAspending award type codes; मिक्स्ड ग्रुप ऑटोमैटिकली valid रिक्वेस्ट में स्प्लिट हो जाते हैं।
`agency`	string	वैकल्पिक	Exact awarding या funding agency नाम फ़िल्टर।
`naicsCodes`	array	वैकल्पिक	NAICS codes जिनसे किसी award को मैच करना ज़रूरी है।
`awardId`	string	वैकल्पिक	जनरेटेड award ID — awardDetail और subawards मोड के लिए runtime पर ज़रूरी।
`maxItems`	number	वैकल्पिक	सेव किए जाने वाले अधिकतम रिकॉर्ड; हर row एक बिल किया जाने वाला इवेंट है (डिफ़ॉल्ट: 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}

प्राइसिंग

Pay-per-event: सेव किए गए हर record पर $0.001, हर सफलतापूर्वक रिटर्न हुई row पर एक बार चार्ज। एक ~1,000-record रन की कीमत ~$1.00 है, और maxItems वॉल्यूम व कॉस्ट दोनों पर कैप लगाता है।

टिप्स

GovCon prospecting के लिए NAICS या PSC codes से शुरुआत करें — ये सीधे उन प्रोडक्ट्स/सेवाओं पर मैप होते हैं जो आप बेचते हैं और सबसे साफ़ रिलेवेंट awards का सेट लौटाते हैं।
individual award डिटेल खींचने से पहले किसी मार्केट के टॉप recipients या agencies को रैंक करने के लिए byCategory मोड इस्तेमाल करें।
Geography मोड हर date-range/award-type कॉम्बिनेशन के लिए पहला पेज (100 rows तक) रिटर्न करता है — state/county/district roll-ups के लिए maxItems बढ़ाने के बजाय फ़िल्टर को संकरा करें।

सामान्य प्रश्न

क्या मुझे API key चाहिए?

नहीं। USAspending.gov API v2 पब्लिक है और इसके लिए किसी key या login की ज़रूरत नहीं।

मिक्स्ड award-type codes को कई रिक्वेस्ट में क्यों स्प्लिट किया जाता है?

USAspending एक ऐसी सिंगल सर्च को रिजेक्ट कर देता है जो अलग-अलग award-type ग्रुप (contracts, IDVs, grants, loans, other financial assistance, direct payments) के codes मिक्स करती है। एक्टर रिक्वेस्टेड codes को ऑटोमैटिकली ग्रुप करता है और हर आउटपुट row को मैच हुए award type codes से टैग करता है।

कौन-कौन से geographic breakdown उपलब्ध हैं?

State, county, congressional district, और country — या तो place of performance या recipient location पर scoped, population और per-capita फ़ील्ड सहित।

एक रन की प्राइसिंग कैसे होती है?

Pay-per-event, प्रति सेव row $0.001, हर सफलतापूर्वक रिटर्न हुए रिकॉर्ड पर एक बार चार्ज। maxItems rows की संख्या और इस तरह कॉस्ट पर कैप लगाता है।