🏛️ Federal Contractor Intelligence — SAM.gov & USAspending in One

Stop guessing which federal contractors are worth your time. This actor builds a complete intelligence profile of any US federal contractor — who they are, what they've won, how much, from which agencies, whether they're growing, whether they're debarred, and a ready-to-use 0–100 lead score — all in one clean export.

While every other tool just dumps a list of open contract opportunities, this one profiles the companies that actually win federal money — perfect for B2G sales, subcontractor sourcing, competitive intelligence, and prospecting.

✅ Works with NO API key (USAspending data) · 🔑 add a free SAM.gov key for full registration & exclusion detail · 🧠 enriched with computed intelligence · 🚫 never returns a null field.

---

🎯 Who is this for?

You are…	You use it to…
A government contractor	Find subcontractors & teaming partners with a proven award history
A B2B sales / BizDev team	Build prospect lists of well-funded contractors (sell them services)
A market / competitive analyst	See who dominates a NAICS code or an agency, and the spend behind them
A capture / proposal manager	Qualify primes before you team — lifetime value, trend, risk
An investor / researcher	Track federal revenue, growth trends and concentration by company

---

🆚 Why this is the most complete option

Capability	Typical SAM.gov / USAspending scrapers	This actor
Open contract opportunities	✅	➖ (this profiles contractors, not RFPs)
Award history per contractor	❌ usually one source	✅ full history + amounts
Lifetime value & contract count	❌	✅
Top agencies they win from	❌	✅ with $ breakdown
Growth trend (12mo vs prior)	❌	✅
Competitor overlap (same NAICS)	❌	✅
0–100 lead score + grade	❌	✅
Debarment / exclusion risk	sometimes	✅
Registration (UEI, CAGE, POC)	one source	✅ merged in
Works with no API key	sometimes	✅ (award data)
Never returns null	❌	✅ guaranteed

Others give you a list. This gives you a decision — who to call, partner with, or sell to, ranked and scored.

🔍 What you can search by

• Company name — Palantir, Booz Allen, Lockheed Martin
• NAICS industry code — 541512 (IT services), 336411 (aircraft) → top contractors in that industry
• Awarding agency — Department of Defense, NASA, Department of Homeland Security
• UEI — the 12-character Unique Entity ID (replaces the old DUNS)

Plus optional filters: minimum contract value, date range (30 days / 12 months / all time), and a debarment/exclusion check.

---

📤 What you get — every field, per contractor

🏢 Identity & registration

Field	Description
contractor_name	Legal recipient name
recipient_uei	Unique Entity ID (12-char)
uei, cage_code	UEI + Commercial and Government Entity code (SAM key)
legal_business_name, dba_name	Registered name + "doing business as" (SAM key)
registration_status, registration_date, expiration_date	SAM registration lifecycle (SAM key)
entity_structure, state_of_incorporation	LLC / Corp / etc. + state (SAM key)
physical_address, website	HQ address + company URL (SAM key)
point_of_contact, poc_email	Government business POC (SAM key)

💰 Award history (USAspending — no key needed)

Field	Description
recent_awards[]	The contractor's largest awards, each with: award_id, award_amount, awarding_agency, awarding_sub_agency, funding_agency, contract_type, naics_code, psc_code, set_aside_type, place_of_performance, start_date, end_date, description
awards_returned	How many award rows are included
primary_naics	The contractor's main industry code

📊 Derived intelligence (the value-add)

Field	Description
total_contracts_count	Total number of federal contracts won
active_contracts_count	Contracts still in their period of performance
total_lifetime_value	Sum of award dollars
avg_contract_value	Average dollars per contract
largest_award_value	Their single biggest award
top_agencies[]	The agencies they win the most from, with $ amounts
agency_count	How many distinct agencies fund them
agency_concentration_pct	% of revenue from their #1 agency (a dependency/risk signal)
top_psc_codes[]	What they actually sell — top Product/Service Codes with $
top_naics_codes[]	Their industries — top NAICS classifications with $
annual_spending[]	Year-by-year federal revenue (fiscal year → amount) — the trend at a glance
growth_trend	increasing / stable / decreasing (last 12 mo vs prior 12 mo)
competitor_overlap[]	Other top contractors in the same NAICS (their competitors)
last_award_date	Most recent award — an activity signal
usaspending_profile	Direct link to their full USAspending profile
lead_score	0–100 — how active & valuable this contractor is
lead_grade	A – Hot / B – Warm / C – Cool / D – Cold

🚫 Risk & compliance (optional)

Field	Description
exclusion_status	clear / EXCLUDED / debarred / not checked
exclusion_reason, exclusion_date	Why & since when, if excluded

🛡️ No nulls, ever. Where a value genuinely doesn't exist you get an empty string or empty list — never a null — so your spreadsheets and pipelines stay clean.

---

⚙️ Examples for every search type

1) Research a specific company (its full award + risk profile)

{ "search_type": "company_name", "search_value": "Palantir",
  "date_range": "all_time", "include_exclusions_check": true, "max_results": 20 }

2) Find the top contractors in an industry (NAICS code) — build a prospect list

{ "search_type": "naics_code", "search_value": "541512",
  "date_range": "last_year", "min_contract_value": 100000, "max_results": 50 }

(541512 = Computer Systems Design Services. Returns the biggest IT contractors, ranked.)

3) See who wins money from a specific agency

{ "search_type": "agency", "search_value": "Department of Defense",
  "date_range": "last_year", "max_results": 50 }

4) Look up a contractor by UEI (Unique Entity ID)

{ "search_type": "uei", "search_value": "ZQGGHJH74DW7",
  "include_exclusions_check": true, "samApiKey": "YOUR_FREE_SAM_KEY" }

💡 Add your free samApiKey to any of the above to also pull registration details (UEI, CAGE, business types, point of contact) and full exclusion records.

📦 Example output (one record, trimmed)

{
  "contractor_name": "PALANTIR TECHNOLOGIES INC",
  "recipient_uei": "ZQGGHJH74DW7",
  "total_contracts_count": 468,
  "total_lifetime_value": 4250000000.0,
  "top_agencies": [
    { "agency": "Department of Defense", "amount": 3043754786.46 },
    { "agency": "Department of Homeland Security", "amount": 460547303.66 }
  ],
  "growth_trend": "increasing",
  "competitor_overlap": ["BOOZ ALLEN HAMILTON INC", "ACCENTURE FEDERAL SERVICES LLC"],
  "last_award_date": "2026-05-18",
  "lead_score": 96,
  "lead_grade": "A - Hot Lead",
  "exclusion_status": "clear",
  "recent_awards": [
    { "award_id": "...", "award_amount": 178000000.0, "awarding_agency": "Department of Defense",
      "naics_code": "541512", "start_date": "2025-01-10", "description": "Data integration platform ..." }
  ]
}

---

🔑 Do I need an API key?

No — it works out of the box. All award data, lifetime totals, agency breakdown, trend and lead score come from USAspending.gov, which is completely free and needs no key.

For the extra registration fields (UEI, CAGE, business types, point of contact) and full exclusion records, add your free SAM.gov API key in the samApiKey field. Getting one takes two minutes: sign in at sam.gov → Account Details → API Key. That's it — no payment, no approval wait.

---

💵 Pricing (pay-per-event — only pay for what you get)

Event	Price
Actor start	$0.02
Per contractor profile	$0.02
Per exclusion check	$0.02

No subscription, no platform-usage surprises — you're billed per result, period.

---

❓ FAQ

Is this legal / where does the data come from? Yes. It uses the official public USAspending.gov and SAM.gov APIs — the same open federal spending and registration data the government publishes.

How is this different from the other SAM.gov scrapers? They list open opportunities (RFPs to bid on). This profiles the contractors themselves — their full award history, lifetime value, agencies, growth, risk and a lead score — merged from two sources into one record. It's intelligence, not a dump.

How far back does the data go? Award data goes back to FY2008. Use the date range to focus on the last 30 days or 12 months for recent activity.

Can I export to Excel / Google Sheets / CRM? Yes — every run produces a clean dataset you can export to CSV, Excel, JSON, or push straight into your CRM via the Apify API/integrations.

---

🔗 Related actors

Looking for company data outside the US? See UKHawk, FRHawk (France), DEHawk (Germany) and MCAHawk (India) for global company intelligence.

---

Keywords: SAM.gov scraper · USAspending API · federal contractor data · government contracts · UEI lookup · CAGE code · NAICS contractors · debarment / exclusion check · B2G lead generation · GovCon prospecting · federal award history · contractor lead score · DoD contractors · government contracting intelligence · subcontractor sourcing.