GovCon Recompete & Spend Shift Watch

Government contractors, capture teams, and public-sector market analysts provide official USAspending filters and receive source-linked recompete candidates, agency spend shifts, and vendor concentration reports. Use the existing award workflow for recompete windows, or select watchMode: "spend_shift" to compare bounded current and prior periods for agency, NAICS, PSC, and recipient watches. The actor uses the keyless official USAspending API, keeps repeated unchanged runs free, and does not make outcome recommendations or predictions.

Store Quickstart

Existing recompete watch

{
  "awardSearches": [
    {
      "id": "cloud-watch",
      "keywords": ["cloud", "modernization"],
      "naicsCodes": ["541512"],
      "daysUntilEnd": 365,
      "minimumAwardAmount": 1000000
    }
  ],
  "generateReport": true,
  "emitUnchanged": false,
  "dryRun": false
}

Spend shift and vendor concentration report

{
  "watchMode": "spend_shift",
  "spendWatches": [
    {
      "id": "defense-cloud",
      "agencyNames": ["Department of Defense"],
      "naicsCodes": ["541512"],
      "pscCodes": ["D310"],
      "lookbackDays": 365,
      "comparisonDays": 365,
      "topRecipients": 10,
      "minimumChangePct": 10
    }
  ],
  "maxSpendingRows": 250,
  "generateReport": true,
  "emitSpendExport": true,
  "emitUnchanged": false,
  "dryRun": false
}

The spend mode makes at most two official USAspending requests per watch and at most 500 award rows per period. It aggregates award amounts by recipient and awarding agency, reports top-recipient share and HHI, and includes source award URLs in the result.

Recipient concentration watch

{
  "watchMode": "spend_shift",
  "spendWatches": [
    {
      "id": "civilian-it-vendors",
      "agencyNames": ["General Services Administration"],
      "recipientNames": ["Example Federal LLC"],
      "naicsCodes": ["541512", "541513"],
      "minimumSpend": 1000000,
      "minimumChangePct": 5
    }
  ],
  "dryRun": false
}

Baseline-only canary

{
  "watchMode": "spend_shift",
  "spendWatches": [{ "id": "baseline", "agencyNames": ["Department of Example"] }],
  "initialRunMode": "baseline_only",
  "emitUnchanged": false,
  "dryRun": false
}

baseline_only saves a complete source snapshot but emits zero rows and zero charges. The normal default emitUnchanged: false also suppresses repeated identical reports, alerts, and exports.

Run the next report

• Generate a govcon-vendor-concentration-report to compare the current period with the prior period for a configured agency, NAICS, PSC, or recipient watch.
• Receive a govcon-spend-shift-alert only when total spend or top-recipient share changes by the configured threshold.
• Enable emitSpendExport for a source-linked govcon-spend-export row.
• Discover new matched tenders and grants before award history exists with Government Tender & Grants Alert Report.
• Use Procurement Intel Actor for a TED-first normalized opportunity queue.

Input Examples

NAICS recompete watch

{
  "awardSearches": [
    {
      "id": "it-services",
      "naicsCodes": ["541512"],
      "daysUntilEnd": 540,
      "minimumAwardAmount": 500000
    }
  ],
  "dryRun": false
}

Incumbent-name watch

{
  "awardSearches": [
    {
      "id": "incumbent-watch",
      "recipientNames": ["Example Federal LLC"],
      "keywords": ["help desk", "cloud"],
      "daysUntilEnd": 365
    }
  ],
  "generateReport": true,
  "dryRun": false
}

Spend watch by agency and PSC

{
  "watchMode": "spend_shift",
  "spendWatches": [{
    "id": "agency-psc",
    "agencyNames": ["Department of Health and Human Services"],
    "pscCodes": ["D399"],
    "lookbackDays": 180,
    "comparisonDays": 180
  }],
  "maxSpendingRows": 100,
  "dryRun": false
}

Output Fields

All rows include sourceName, sourceUrl, sourceUrls, retrievedAt, fetchedAt, sourceMethod, authorizationBasis, limitations, warnings, and prohibitedInterpretations.

Existing award rows include award, incumbentName, daysUntilEnd, and the existing recompete fields.

Spend rows include:

• govcon_vendor_concentration_report: current and comparison periods, total spend, spend change, top recipients, recipient share, HHI, agency totals, and source URLs.
• govcon_spend_shift_alert: material total-spend or recipient-concentration changes, with current/comparison values and source URLs.
• govcon_spend_export: optional source-linked JSON aggregation export.

Pricing And No-Change Runs

Existing event names and prices remain unchanged:

• govcon-recompete-candidate: $0.080 per source-linked recompete candidate.
• govcon-incumbent-map-generated: $0.100 per incumbent map summary.
• govcon-incumbent-change-detected: $0.060 per incumbent or award-content change signal.
• govcon-incumbent-award-observed: $0.004 per optional award observation row.
• govcon-recompete-watch-report: $6.000 per recompete portfolio report.

Spend mode adds explicit value events:

• govcon-spend-shift-alert: $0.500 per material spend or concentration alert.
• govcon-vendor-concentration-report: $12.000 per source-linked vendor concentration report.
• govcon-spend-export: $5.000 per requested source-linked spend export.

When emitUnchanged=false, repeated unchanged runs emit zero dataset rows and zero charges. A failed official API request is not committed to state, so a partial snapshot cannot create a false shift on the next run.

Compliance Guardrails

• Official public USAspending data only; the adapter is keyless and bounded.
• fixturePath is dry-run/test-only and is rejected for public non-dry runs.
• This is an unofficial tool and is not affiliated with USAspending, SAM.gov, GSA, or any government agency.
• No private notices, government approval wording, source-selection inference, legal guidance, protest guidance, or bid/no-bid recommendation.
• Spend percentages, concentration metrics, and change alerts are descriptive calculations over retrieved public rows, not forecasts or recommendations.
• Rows are source-linked public facts for human review; agency and recipient names are displayed as returned by the source.

Bundle Paths

• GovCon Capture: use the existing recompete workflow for incumbent and end-date watches, then use govcon-vendor-concentration-report for agency/vendor context.
• Opportunity discovery: run Government Tender & Grants Alert Report before award history exists.
• Use Procurement Intel Actor when a TED-first queue is the right starting point.

See Also

• Government Tender & Grants Alert Report
• Procurement Intel Actor