search_opportunities
Search SAM.gov contract opportunities
Search active federal contract opportunities on SAM.gov: solicitations, presolicitations, sources sought, RFIs, and award notices - filterable by keywords, NAICS, set-aside (SDVOSB, 8(a), HUBZone, WOSB, small business), notice type, agency, and posted-date range (max 1 year). Call this when the user wants to find federal bidding opportunities or market intelligence on what agencies are buying. Requires the caller's own free SAM.gov API key (X-Sam-Api-Key header or sam_api_key argument); without one it returns an error explaining how to get and pass a key.
输入参数limitagencykeywordsposted_toset_asidenaics_codesnotice_typeposted_fromsam_api_key
lookup_entity
Look up a SAM.gov registered entity
Look up a federal contractor registration in SAM.gov by Unique Entity ID (UEI) or legal business name: registration status, CAGE code, physical address, business types (SDVOSB, 8(a), HUBZone, etc.), and NAICS codes. Call this to vet a teaming partner, check a competitor, or confirm an entity is award-eligible. Public registration sections only. Requires the caller's own free SAM.gov API key (X-Sam-Api-Key header or sam_api_key argument).
输入参数ueinamesam_api_key
search_awards
Search federal contract awards (USASpending)
Search actual federal contract awards on USAspending.gov - who won what, from which agency, for how much. Filter by keywords, NAICS, PSC, recipient name, agency, date range, and award amount. Keyless and unlimited. Call this for competitive intelligence ("who holds contracts in this space"), incumbent research, or agency spending patterns.
输入参数limitend_datekeywordspsc_codesrecipientmax_amountmin_amountstart_dateagency_namenaics_codes
get_award
Get one federal award (USASpending)
Get full detail for one federal award from USAspending.gov by its generated award id (from search_awards results, e.g. "CONT_AWD_...") - description, obligations, period of performance, awarding/funding agencies, recipient, and place of performance. Keyless.
输入参数award_id必填
find_agency
Find a federal agency by name
Resolve a federal agency name fragment to its official awarding-agency names (toptier and subtier) as USAspending knows them - use before search_awards or spending_by_category when unsure of the exact agency name. Keyless.
输入参数query必填
find_naics
Find NAICS codes
Resolve an industry description to NAICS codes (or look up what a NAICS code means). Use before search_opportunities/search_awards to get the right code. Keyless.
输入参数query必填
spending_by_category
Federal spending rollups
Aggregate federal contract spending by NAICS, PSC, recipient, or awarding agency over a date range, optionally filtered by keywords/NAICS/agency - market sizing in one call ("top contractors in NAICS 541512 last year", "which agencies buy the most cybersecurity"). Keyless.
输入参数limitcategory必填end_datekeywordsstart_dateagency_namenaics_codes