Skip to main content
Glama
jlucasmcrell

Apify Public Data & Leads

USAspending Federal Procurement and Defense Awards Search

usaspending_contracts
Read-only

Search and retrieve U.S. federal contract awards by prime contractor name, including defense obligations, from the official USAspending database for procurement intelligence and vendor tracking.

Instructions

Search United States federal procurement contracts, defense department awards, and prime agency obligations from the official USAspending database.

Behavioral Transparency:

  • Execution: Network call executed synchronously in the cloud via Apify Actor 'captainhandsome/usaspending-federal-awards'.

  • Side Effects: Reads public sources and creates a billed Actor run and dataset on your Apify account.

  • Authentication: Requires APIFY_TOKEN environment variable.

  • Latency & Limits: Typical run duration is 10-35 seconds; timeout capped at 120 seconds.

Usage Guidelines:

  • When to use: Use for government contracting intelligence, prime federal vendor tracking, defense obligation amounts, and public procurement research.

  • When NOT to use: Do not use for commercial retail leads, corporate equity SEC filings, or consumer vacation pricing.

  • Named alternatives: Use 'sec_edgar_filings' for corporate 10-K annual reports, 'google_maps_search' for private commercial trade vendors, or 'glassdoor_jobs_search' for company hiring data.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
max_resultsNoMaximum number of federal contract award records to retrieve. Defaults to 10.
recipient_nameYesLegal entity name of the prime contractor, corporate vendor, or recipient institution (e.g. 'Lockheed Martin', 'Palantir Technologies', or 'Boeing').

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
runNo
errorNo
statusYes
resultsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed94 schema fields changedv1.1.0
    • addedInput schema / additionalProperties
      Added value: +false
    • addedOutput schema / properties / error
      Added value: +{
      +  "type": "object"
      +}
    • removedOutput schema / properties / results / description
      Removed value: -"Collection of official federal contract and award obligation records."
    • addedOutput schema / properties / results / items / properties / amount
      Added value: +{
      +  "description": "Structured amount value returned by the upstream source.",
      +  "title": "Amount",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / assistance_listings
      Added value: +{
      +  "description": "Every CFDA program attached to the award as 'number title', comma separated and capped at ten.",
      +  "title": "Assistance listings",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / results / items / properties / awardDate
      Removed value: -{
      -  "description": "Action signing date in YYYY-MM-DD format.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / results / items / properties / awardDescription
      Removed value: -{
      -  "description": "Executive summary statement of the contracted goods or defense services.",
      -  "type": "string"
      -}
    • addedOutput schema / properties / results / items / properties / award_family
      Added value: +{
      +  "description": "Structured award family value returned by the upstream source.",
      +  "title": "Award Family",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / award_id
      Added value: +{
      +  "description": "USAspending-generated federal award identifier.",
      +  "title": "Award identifier",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / award_type
      Added value: +{
      +  "description": "Structured award type value returned by the upstream source.",
      +  "title": "Award Type",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / award_type_code
      Added value: +{
      +  "description": "Raw federal award type code behind the award type description - A-D for contracts, IDV_A-IDV_E for vehicles, 02-05 grants, 06/10 direct payments, 07/08 loans. Requires Fetch full award details.",
      +  "title": "Award type code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / results / items / properties / awardingAgency
      Removed value: -{
      -  "description": "Federal department or agency authorizing the procurement contract.",
      -  "type": "string"
      -}
    • addedOutput schema / properties / results / items / properties / awarding_agency
      Added value: +{
      +  "description": "Structured awarding agency value returned by the upstream source.",
      +  "title": "Awarding Agency",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / awarding_agency_code
      Added value: +{
      +  "description": "Top-tier CGAC code of the agency that made the award.",
      +  "title": "Awarding agency code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / awarding_office
      Added value: +{
      +  "description": "Contracting office that issued the award, one level below the sub-agency. Requires Fetch full award details.",
      +  "title": "Awarding office",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / awarding_sub_agency
      Added value: +{
      +  "description": "Structured awarding sub agency value returned by the upstream source.",
      +  "title": "Awarding Sub Agency",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / awarding_sub_agency_code
      Added value: +{
      +  "description": "Sub-tier code of the awarding office's parent component.",
      +  "title": "Awarding sub-agency code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / base_and_all_options
      Added value: +{
      +  "description": "Total contract ceiling if every option is exercised - the number a competitor's pipeline is sized on. Requires Fetch full award details.",
      +  "title": "Base and all options (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / base_exercised_options
      Added value: +{
      +  "description": "Award value including options exercised so far. Requires Fetch full award details.",
      +  "title": "Base and exercised options (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / base_obligation_date
      Added value: +{
      +  "description": "Date of the earliest obligating action on the award. Populated for every award family, including the ones with no period of performance.",
      +  "title": "Base obligation date",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / cfda_number
      Added value: +{
      +  "description": "Structured cfda number value returned by the upstream source.",
      +  "title": "Cfda Number",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / cfda_program_title
      Added value: +{
      +  "description": "Title of the CFDA / Assistance Listings program that funded this grant, loan or direct payment.",
      +  "title": "Assistance program title",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / results / items / properties / contractId
      Removed value: -{
      -  "description": "Unique federal procurement award ID (PIID or FAIN).",
      -  "type": "string"
      -}
    • addedOutput schema / properties / results / items / properties / contract_pricing_type
      Added value: +{
      +  "description": "Pricing arrangement, for example firm fixed price or cost plus fixed fee. Requires Fetch full award details.",
      +  "title": "Contract pricing type",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / covid19_obligations
      Added value: +{
      +  "description": "Portion of the award obligated from COVID-19 supplemental appropriations.",
      +  "title": "COVID-19 obligations (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / covid19_outlays
      Added value: +{
      +  "description": "Portion of the award actually paid out from COVID-19 supplemental appropriations.",
      +  "title": "COVID-19 outlays (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / date_signed
      Added value: +{
      +  "description": "Date the award was signed, which can precede the period of performance. Requires Fetch full award details.",
      +  "title": "Date signed",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / def_codes
      Added value: +{
      +  "description": "DEFC codes tying the award to emergency appropriations such as COVID-19 relief or infrastructure, comma separated.",
      +  "title": "Disaster emergency fund codes",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / description
      Added value: +{
      +  "description": "Structured description value returned by the upstream source.",
      +  "title": "Description",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / end_date
      Added value: +{
      +  "description": "Structured end date value returned by the upstream source.",
      +  "title": "End Date",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / executive_compensation
      Added value: +{
      +  "description": "Named executives of the awardee and their reported pay, comma separated and capped at five. Requires Fetch full award details.",
      +  "title": "Executive compensation",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / extent_competed
      Added value: +{
      +  "description": "How openly the contract was competed. Requires Fetch full award details.",
      +  "title": "Extent competed",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / funding_agency
      Added value: +{
      +  "description": "Top-tier agency whose appropriation paid for the award, which is often not the agency that awarded it.",
      +  "title": "Funding agency",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / funding_agency_code
      Added value: +{
      +  "description": "Top-tier CGAC code of the agency that funded the award.",
      +  "title": "Funding agency code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / funding_office
      Added value: +{
      +  "description": "Office whose funds paid for the award. Requires Fetch full award details.",
      +  "title": "Funding office",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / funding_opportunity_number
      Added value: +{
      +  "description": "Grant funding opportunity announcement this assistance award was made under. Requires Fetch full award details.",
      +  "title": "Funding opportunity number",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / funding_sub_agency
      Added value: +{
      +  "description": "Sub-tier component whose budget funded the award.",
      +  "title": "Funding sub-agency",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / funding_sub_agency_code
      Added value: +{
      +  "description": "Sub-tier code of the funding component.",
      +  "title": "Funding sub-agency code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / infrastructure_obligations
      Added value: +{
      +  "description": "Portion of the award obligated from Infrastructure Investment and Jobs Act appropriations.",
      +  "title": "Infrastructure obligations (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / infrastructure_outlays
      Added value: +{
      +  "description": "Portion of the award actually paid out from Infrastructure Investment and Jobs Act appropriations.",
      +  "title": "Infrastructure outlays (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / issued_date
      Added value: +{
      +  "description": "Date the loan was issued. Loans carry this instead of a period of performance.",
      +  "title": "Loan issue date",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / last_date_to_order
      Added value: +{
      +  "description": "Final date an order can be placed against this IDV - when the vehicle stops being sellable.",
      +  "title": "Last date to order",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / last_modified_date
      Added value: +{
      +  "description": "Timestamp of the most recent update to this award record in the federal source systems.",
      +  "title": "Last modified",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / naics_code
      Added value: +{
      +  "description": "Structured naics code value returned by the upstream source.",
      +  "title": "Naics Code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / naics_description
      Added value: +{
      +  "description": "Structured naics description value returned by the upstream source.",
      +  "title": "Naics Description",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / naics_sector_code
      Added value: +{
      +  "description": "Two-digit NAICS sector the detailed industry code rolls up to. Requires Fetch full award details.",
      +  "title": "NAICS sector code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / naics_sector_description
      Added value: +{
      +  "description": "Name of the two-digit NAICS sector. Requires Fetch full award details.",
      +  "title": "NAICS sector",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / non_federal_funding
      Added value: +{
      +  "description": "Cost share contributed by the recipient or other non-federal sources. Requires Fetch full award details.",
      +  "title": "Non-federal funding (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / number_of_offers_received
      Added value: +{
      +  "description": "Number of bids received on the solicitation - how crowded the competition was. Requires Fetch full award details.",
      +  "title": "Offers received",
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / results / items / properties / obligationAmount
      Removed value: -{
      -  "description": "Total monetary obligation amount funded by the federal government in USD.",
      -  "type": "number"
      -}
    • addedOutput schema / properties / results / items / properties / other_than_full_and_open
      Added value: +{
      +  "description": "FAR authority cited when the award was not fully competed. Requires Fetch full award details.",
      +  "title": "Sole-source justification",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / parent_award_id
      Added value: +{
      +  "description": "PIID of the IDV or contract vehicle this order was placed against. Requires Fetch full award details.",
      +  "title": "Parent award ID",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / parent_award_type
      Added value: +{
      +  "description": "Type of the parent contract vehicle, for example IDC, BPA or GWAC. Requires Fetch full award details.",
      +  "title": "Parent award type",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / parent_recipient_name
      Added value: +{
      +  "description": "Ultimate parent company of the awardee, which rolls subsidiaries up to the corporate group. Requires Fetch full award details.",
      +  "title": "Parent company",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / parent_recipient_uei
      Added value: +{
      +  "description": "Unique Entity Identifier of the awardee's ultimate parent. Requires Fetch full award details.",
      +  "title": "Parent company UEI",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / pop_city
      Added value: +{
      +  "description": "Structured pop city value returned by the upstream source.",
      +  "title": "Pop City",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / pop_congressional_district
      Added value: +{
      +  "description": "Congressional district where the work is performed. Requires Fetch full award details.",
      +  "title": "Place of performance district",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / pop_country
      Added value: +{
      +  "description": "Country where the work is performed.",
      +  "title": "Place of performance country",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / pop_country_code
      Added value: +{
      +  "description": "Three-letter country code of the place of performance.",
      +  "title": "Place of performance country code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / pop_county
      Added value: +{
      +  "description": "County where the work is performed. Requires Fetch full award details.",
      +  "title": "Place of performance county",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / pop_state
      Added value: +{
      +  "description": "Structured pop state value returned by the upstream source.",
      +  "title": "Pop State",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / pop_zip
      Added value: +{
      +  "description": "Structured pop zip value returned by the upstream source.",
      +  "title": "Pop Zip",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / potential_end_date
      Added value: +{
      +  "description": "End date if every option is exercised, as against the current end date. Requires Fetch full award details.",
      +  "title": "Potential end date",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / psc_category_code
      Added value: +{
      +  "description": "Single-letter Product Service Code category the detailed PSC rolls up to. Requires Fetch full award details.",
      +  "title": "PSC category code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / psc_category_description
      Added value: +{
      +  "description": "Name of the Product Service Code category. Requires Fetch full award details.",
      +  "title": "PSC category",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / psc_code
      Added value: +{
      +  "description": "Structured psc code value returned by the upstream source.",
      +  "title": "Psc Code",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / psc_description
      Added value: +{
      +  "description": "Structured psc description value returned by the upstream source.",
      +  "title": "Psc Description",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / results / items / properties / recipientName
      Removed value: -{
      -  "description": "Legal business or institutional name of the award recipient.",
      -  "type": "string"
      -}
    • addedOutput schema / properties / results / items / properties / recipient_address
      Added value: +{
      +  "description": "Awardee street address; the source's up-to-three address lines joined with a comma.",
      +  "title": "Recipient street address",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / recipient_business_categories
      Added value: +{
      +  "description": "Socio-economic and entity classifications of the awardee - small business, 8(a), veteran owned, nonprofit and so on - comma separated. Requires Fetch full award details.",
      +  "title": "Recipient business categories",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / recipient_city
      Added value: +{
      +  "description": "City where the awardee is based, as distinct from where the work is performed.",
      +  "title": "Recipient city",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / recipient_congressional_district
      Added value: +{
      +  "description": "Congressional district of the awardee's location. Requires Fetch full award details.",
      +  "title": "Recipient congressional district",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / recipient_country
      Added value: +{
      +  "description": "Country of the awardee's own location.",
      +  "title": "Recipient country",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / recipient_county
      Added value: +{
      +  "description": "County of the awardee's own location. Requires Fetch full award details.",
      +  "title": "Recipient county",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / recipient_name
      Added value: +{
      +  "description": "Structured recipient name value returned by the upstream source.",
      +  "title": "Recipient Name",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / recipient_profile_url
      Added value: +{
      +  "description": "USAspending.gov profile page for this recipient, showing every award it has received.",
      +  "title": "Recipient profile URL",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / recipient_state
      Added value: +{
      +  "description": "Two-letter state code of the awardee's own location.",
      +  "title": "Recipient state",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / recipient_uei
      Added value: +{
      +  "description": "Unique Entity Identifier of the awardee - the SAM.gov successor to DUNS, and the key you join federal award data on.",
      +  "title": "Recipient UEI",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / set_aside_type
      Added value: +{
      +  "description": "Socio-economic set-aside the contract was reserved under, for example 8(a), SDVOSB or HUBZone. Requires Fetch full award details.",
      +  "title": "Set-aside type",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / solicitation_id
      Added value: +{
      +  "description": "Identifier of the solicitation this award came from, for tying the award back to the original opportunity. Requires Fetch full award details.",
      +  "title": "Solicitation ID",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / solicitation_procedures
      Added value: +{
      +  "description": "Procurement procedure used to solicit the award. Requires Fetch full award details.",
      +  "title": "Solicitation procedures",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / start_date
      Added value: +{
      +  "description": "Structured start date value returned by the upstream source.",
      +  "title": "Start Date",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / subaward_count
      Added value: +{
      +  "description": "Number of subawards reported under this award. Requires Fetch full award details.",
      +  "title": "Subaward count",
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / subsidy_cost
      Added value: +{
      +  "description": "Structured subsidy cost value returned by the upstream source.",
      +  "title": "Subsidy Cost",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / top_executive_compensation
      Added value: +{
      +  "description": "Reported compensation of the highest-paid executive, as a sortable number. Requires Fetch full award details.",
      +  "title": "Top executive pay (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / top_executive_name
      Added value: +{
      +  "description": "Highest-paid reported executive of the awardee. Requires Fetch full award details.",
      +  "title": "Top executive",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / total_funding
      Added value: +{
      +  "description": "Federal obligation plus non-federal cost share. Requires Fetch full award details.",
      +  "title": "Total funding (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / total_outlays
      Added value: +{
      +  "description": "Structured total outlays value returned by the upstream source.",
      +  "title": "Total Outlays",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / total_subaward_amount
      Added value: +{
      +  "description": "Dollar value flowing to subcontractors and subrecipients under this award. Requires Fetch full award details.",
      +  "title": "Total subaward amount (USD)",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / results / items / properties / url
      Added value: +{
      +  "description": "Direct URL for the source listing.",
      +  "title": "Canonical listing URL",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / results / items / required
      Removed value: -[
      -  "recipientName",
      -  "obligationAmount"
      -]
    • addedOutput schema / properties / run
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / status
      Added value: +{
      +  "enum": [
      +    "success",
      +    "empty_unverified",
      +    "partial",
      +    "error"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "results"
      -]New value: +[
      +  "results",
      +  "status"
      +]
  2. Changed6 schema fields changedv1.0.6
    • addedInput schema / properties / max_results / description
      Added value: +"Maximum number of federal contract award records to retrieve. Defaults to 10."
    • addedInput schema / properties / max_results / maximum
      Added value: +100
    • addedInput schema / properties / max_results / minimum
      Added value: +1
    • changedInput schema / properties / recipient_name / description
      Previous value: -"e.g. 'Lockheed Martin' or 'Palantir'"New value: +"Legal entity name of the prime contractor, corporate vendor, or recipient institution (e.g. 'Lockheed Martin', 'Palantir Technologies', or 'Boeing')."
    • addedInput schema / properties / recipient_name / minLength
      Added value: +2
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "results": {
      +      "description": "Collection of official federal contract and award obligation records.",
      +      "items": {
      +        "properties": {
      +          "awardDate": {
      +            "description": "Action signing date in YYYY-MM-DD format.",
      +            "type": "string"
      +          },
      +          "awardDescription": {
      +            "description": "Executive summary statement of the contracted goods or defense services.",
      +            "type": "string"
      +          },
      +          "awardingAgency": {
      +            "description": "Federal department or agency authorizing the procurement contract.",
      +            "type": "string"
      +          },
      +          "contractId": {
      +            "description": "Unique federal procurement award ID (PIID or FAIN).",
      +            "type": "string"
      +          },
      +          "obligationAmount": {
      +            "description": "Total monetary obligation amount funded by the federal government in USD.",
      +            "type": "number"
      +          },
      +          "recipientName": {
      +            "description": "Legal business or institutional name of the award recipient.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "recipientName",
      +          "obligationAmount"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "results"
      +  ],
      +  "type": "object"
      +}
  3. First observedv0.1.0

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint and destructiveHint, but the description adds valuable context: synchronous execution via Apify Actor, billing side effects (billed run and dataset), authentication requirement (APIFY_TOKEN), and latency limits. This goes beyond annotations and helps agents anticipate costs and runtime.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with distinct sections for purpose, behavior, and usage. Every bullet adds information and is directly relevant. No filler or redundancy exists; the length is justified by the tool's operational complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the description need not detail return values. It covers execution environment, side effects, authentication, latency, and usage boundaries. For a network-backed tool with two parameters, nothing an agent needs to invoke it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers 100% of parameters with clear descriptions (recipient_name with examples, max_results with bounds and default). The description adds no additional semantic detail about the parameters themselves, so it meets the baseline but does not exceed it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('Search') and a clear resource ('federal procurement contracts, defense department awards, and prime agency obligations') from the official USAspending database. It distinguishes itself from siblings by explicitly naming alternatives like sec_edgar_filings and google_maps_search.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides explicit when-to-use guidance (government contracting intelligence, prime vendor tracking) and when-not-to-use scenarios (commercial retail, SEC filings, vacation pricing). It also names specific alternative tools for each excluded use case, leaving no ambiguity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.