get_catalog
What SpendQuery can answer
What SpendQuery can answer: data coverage, metrics, dimensions (with examples and whether
they apply to contracts or assistance), analyses, the QueryPlan JSON schema, planning rules
and example question -> plan pairs. Call this first (no arguments): the federal catalog.
section: "states" (state, county and city checkbooks in brief: each jurisdiction, their
dimensions, rules and examples), "state:<CODE>" (one jurisdiction in full, e.g. "state:MA"),
"rules" (every planning rule), "examples" (every worked example) or "full" (everything).
輸入參數section
run_plan
Run a spending query
Run a QueryPlan (see get_catalog.plan_schema). Returns status (ok | clarify |
unsupported | error), a one-paragraph answer, columns, rows (max 100), the SQL that ran,
caveats and how names were resolved to codes.
輸入參數plan必填
search_codes
Search agencies, industries and product codes
Look up codes and official names. kind: agency | bureau | state | county | naics | psc |
program. Matches names (substring, case-insensitive) or code prefixes. Plans can use either
the names or the codes.
輸入參數kind必填limitquery必填
search_recipients
Search companies and recipients
Find award recipients (companies, universities, governments) by name or UEI. Returns
each registration's UEI, parent, listed-company ticker (if matched) and its OWN obligations
across loaded years, largest first. A parent's money sits on its units, so a parent UEI's own
obligations can be small or negative: for a company's total use run_plan with a company
filter (name or ticker). A UEI that is a parent also returns parent_rollup (its units).
輸入參數limitquery必填
browse_codes
Browse industry and product codes
Browse what the government buys, with contract spend. kind: psc (products and services)
| naics (industries). No group and no query -> the groups (PSC: services by letter, e.g. D =
IT services, R = professional support; products by 2 digits, e.g. 84 = clothing and
individual equipment; NAICS: 2-digit sectors), largest first. group -> the codes in it.
query -> codes whose name contains the words. Default year: last complete fiscal year.
Use a code or its name in a plan's psc / naics filter.
輸入參數kindgrouplimitqueryfiscal_year
get_notice
Look up a contract notice
One SAM.gov contract notice as SpendQuery's brief sees it, no AI: the decision card (what
the buyer needs, blockers, unknowns, a next step; each line labelled record / files /
unknown), the timeline of the buy (planned buy, the contract it follows, earlier and newer
notices, the award and the contract it became, each link confirmed / likely / possible) and
what changed between versions of its public files. notice_id: from run_plan lists of
contract_opportunities, or the id in a SAM.gov notice URL.
輸入參數notice_id必填
size_standard
Check an SBA size standard
SBA small business size standards (13 CFR 121.201, the eCFR table): a NAICS code, a code
prefix (5415) or industry words -> receipts ($ millions) or employees, exceptions and
footnotes, and the programs that use them.
輸入參數query必填
naics_finder
Find NAICS codes for a business
Describe the work in plain words -> the NAICS codes buyers actually use for it (codes on
SAM.gov notices whose titles have the words and on federal contracts described with them),
each with its SBA size standard.
輸入參數description必填
vehicle_match
Find contract vehicles for an industry
For 6-digit NAICS codes (and an optional agency): the shared contract vehicles (GWACs,
multiple-award IDIQs, GSA Schedule, BPAs) carrying last complete year's contract money in those
codes, the share through each and who each is reserved for (read from its name).
輸入參數naics必填agency
search_far
Search the FAR and DFARS
Search the FAR and the DFARS (48 CFR chapters 1 and 2, as codified in the eCFR): sections
whose title or text has every word, or a section number (e.g. 52.219-14) straight to it.
reg: FAR | DFARS to limit. Returns section numbers, titles and a snippet; read one with
get_far_section. The codified text lags the Revolutionary FAR Overhaul's class deviations.
輸入參數regquery必填
get_far_section
Read a FAR or DFARS section
One FAR or DFARS section's full text (paragraphs), its part and subpart, the sections it
refers to and the ones referring to it, and Federal Register rules changing its part. Cite
it as FAR <section> (or DFARS) with the as-of date in source.
輸入參數section必填
search_local_bids
Search state and local bids and contracts
State, county and city government bids and contracts (not federal awards), from the
governments that publish them as open data: Los Angeles (the City, LA County, LADWP, LAUSD,
airports, port, Metro), New York City, San Francisco, Washington DC, Chicago, Cook County,
Austin, Detroit, Richmond, Sacramento, Baton Rouge, Montgomery County MD, Delaware, Texas DOT,
California state departments (Cal eProcure), SUNY construction, E-Rate and others.
kind: "open" (taking responses, soonest due first), "planned" (forecasts: TxDOT's planned
lettings, Illinois CDB, San Diego County), "awarded" (contracts first awarded in the last
year: who won, net amounts) or "current" (in force today, soonest ending first: the re-bids).
q: words in the title or description; state: two-letter code (open and planned bids);
source: one source key from the reply's sources. Coverage is partial: no tool has every
state, county and city; say so when the place asked about isn't covered. Each row links to
the government's own record (source_url).
輸入參數qkindlimitstatesource
sbir_awards
Search SBIR and STTR awards
SBIR and STTR awards since 1983 from SBA's SBIR.gov records, and who received them:
totals, awards by year (Phase I / II), by agency, the companies with the most, and the
latest awards (company, title, agency, phase, amount, year). Filters: agency (as SBIR.gov
names it, e.g. "Department of Defense"), phase ("Phase I" or "Phase II"), program ("SBIR" or
"STTR"), state (the winner's), q (words in the award title), company_uei, since (first award
year). open_topics: also the SBIR/STTR solicitations open now (SAM.gov and Grants.gov).
SBIR.gov counts awards by award year; USAspending (run_plan) counts money by fiscal year, so
the two differ.
輸入參數qphasesincestateagencyprogramcompany_ueiopen_topics