TED · USASpending awards

TED and USASpending award-change reports and optional SAM.gov

This Actor watches public award records from TED and USASpending (SAM.gov awards optional with a user key) and can emit alerts, a supplier-share report, and an export. Default generateReport is true ($4) when new evidence exists; emitRawRows defaults false.

Not a bid/no-bid desk, not SAM opportunity search (use TED/SAM Grants Bid Alerts), and not affiliated with any agency. Unchanged runs: 0 rows / 0 charge.

from $4.00 / 1,000 govcon-award-row events ($0.004 each, optional raw rows); $0.12 per govcon-spend-change-alert; $4.00 per govcon-supplier-share-report; $3.00 per govcon-award-export. No Actor Start. Default maxChargeUsd 10. Unchanged runs free.

Open Government Contract Award Change Report on Apify

Government Contract Award Change Report, not a neighboring Actor

Use this page for this Actor’s job. Use TED, SAM.gov & Grants Bid Alerts for Open opportunities / tenders.

This Actor TED, SAM.gov & Grants Bid Alerts
Intent Government Contract Award Change Report Open opportunities / tenders
Primary input feeds keywords / jurisdictions
What it reads Public sources listed on the Store page SAM/TED/Grants notices
Primary output Dataset rows billed per live PPE opportunity rows
Not this job Not a bid/no-bid desk, not SAM opportunity search (use TED/SAM Grants Bid Alerts), and not affiliated with any agency. Unchanged runs: 0 rows / 0 charge. Not post-award spend/award change reports

Store ID: taroyamada/government-contract-award-monitor. Respect source terms, robots.txt, and rate limits.

Use cases

How is Government Contract Award Change Report different from TED, SAM.gov & Grants Bid Alerts?

Government Contract Award Change Report (taroyamada/government-contract-award-monitor): This Actor watches public award records from TED and USASpending (SAM.gov awards optional with a user key) and can emit alerts, a supplier-share report, and an export. Default generateReport is true ($4) when new evidence exists; emitRawRows defaults false. Not a bid/no-bid desk, not SAM opportunity search (use TED/SAM Grants Bid Alerts), and not affiliated with any agency. Unchanged runs: 0 rows / 0 charge. TED, SAM.gov & Grants Bid Alerts is for Open opportunities / tenders (input keywords / jurisdictions; SAM/TED/Grants notices; opportunity rows). Not post-award spend/award change reports.

What input is required?

Live required fields: feeds. exampleRunInput is TED digital-services awards, watchTerms consultancies, minValue 100000, datasetMode all, notifyOnNoNew true, generateReport left at schema default true. SAM feeds need samApiKey. Keep maxChargeUsd at or above report+alerts.

Field Type Default Notes
feeds array required empty Award feeds to monitor (required). One entry per watch target. Each feed produces one digest row in the output. At minimum, set id, name, and source. Add keywords, cpvCodes, naicsCodes, or agencyName to narrow the awa…
watchTerms string empty Watch terms — awardee / competitor / incumbent names (comma-separated). Company names, incumbents, or competitor terms to flag in award notices. Any award matching a watch term receives a watch_term_hit signal tag and…
lookbackDays integer 14 Award lookback window (days). Fetch award notices published within this many days. Keep it short (7–30) for recurring runs to stay fast; widen it for initial discovery.
maxAwardsPerFeed integer 50 Max awards per feed. Upper bound on awards fetched per feed per run. Increase for discovery runs; keep lower for recurring digest runs.
minValue number 0 Global minimum award value (currency units). Skip awards below this value. Applied globally unless overridden per feed. Set 0 to include all.
delivery string dataset Delivery mode. dataset stores results in the Apify dataset. webhook posts the digest JSON to webhookUrl.
webhookUrl string empty Webhook URL (required when delivery=webhook). POST target for award digest payload. Leave empty for dataset delivery.
datasetMode string new_only Dataset output mode. all emits every feed digest row. action_needed emits only feeds that have new awards or watch-term hits. new_only emits only feeds with awards not seen in the previous run.
snapshotKey string contract-award-monitor-state Snapshot key for recurring state. Stable key used to persist seen award IDs across recurring runs so new_only and action_needed modes stay comparable. Use the same key across scheduled runs.
samApiKey string empty SAM.gov API key (required for sam_awards feeds). SAM.gov API key from Account Details on sam.gov. Required for sam_awards source feeds. If missing, sam_awards feeds are skipped with a warning.
samApiUrl string https://api.sam.gov/opportunities/v2/search SAM.gov opportunities API URL. SAM.gov opportunities search endpoint used for award-type records.
tedApiUrl string https://api.ted.europa.eu/v3/notices/search TED API URL (ted_awards feeds). TED notices search endpoint. No API key required.
usaSpendingApiUrl string https://api.usaspending.gov/api/v2/search/spending_by_award/ USASpending.gov API URL (usaspending feeds). USASpending.gov awards search endpoint. No API key required.
requestTimeoutSeconds integer 30 HTTP request timeout (seconds). Timeout for each API request.
notifyOnNoNew boolean false Emit digest even when no new awards found. When true, every feed always produces a digest row even if no new awards were found. When false, feeds with no new awards are omitted from the output.
emitRawRows boolean false Include raw award rows. When enabled, new source-linked award rows are delivered at $0.004 each.
generateReport boolean true Generate supplier-share report. Generate one buyer-facing supplier-share report when new award evidence is found.
emitExport boolean false Generate award export. Generate a consolidated export when new award evidence is found.
maxChargeUsd number 10 Maximum event charge per run. Fail before delivery when the estimated PPE event charge exceeds this amount. Set 0 for no cap.
dryRun boolean false Dry run (skip snapshot writes and webhook delivery). Validate and fetch without persisting state or posting webhooks. Safe for testing input shapes.
nowIso string empty Override current time (ISO string, for testing). Set to a fixed ISO timestamp to make runs deterministic against fixture data.
tedFixturePath string empty TED fixture file path (testing). Local JSON fixture for offline TED award tests.
samFixturePath string empty SAM fixture file path (testing). Local JSON fixture for offline SAM award tests.
usaSpendingFixturePath string empty USASpending fixture file path (testing). Local JSON fixture for offline USASpending tests.

Published Store example run input (omitted fields take schema defaults):

{
  "feeds": [
    {
      "id": "ted-digital-services-awards",
      "name": "TED EU Digital Services Awards",
      "source": "ted_awards",
      "keywords": "digital services,IT consultancy,cloud",
      "cpvCodes": "72000000,72220000",
      "buyerCountry": ""
    }
  ],
  "watchTerms": "Accenture,Capgemini,Deloitte,IBM",
  "lookbackDays": 14,
  "maxAwardsPerFeed": 50,
  "minValue": 100000,
  "delivery": "dataset",
  "datasetMode": "all",
  "snapshotKey": "contract-award-monitor-quickstart",
  "notifyOnNoNew": true,
  "dryRun": false
}

Run Government Contract Award Change Report on Apify

How do dataset, webhook, and dry-run delivery work?

delivery defaults to dataset on the live schema. Dataset output is the billable surface when rows are written. webhookUrl is used when delivery is webhook (and typically not during dryRun). dryRun true validates or samples without the usual dataset/webhook side effects described on the Store schema. datasetMode can limit emits to changes_only versus all. Unchanged runs that write zero default-dataset rows typically charge $0.00 on current PPE.

What does a result contain?

Published README Output Example / Sample Output JSON.

{
  "rowType": "govcon_supplier_share_report",
  "stableKey": "report:eu-cloud-awards-v1:4d962b5a7c2a",
  "billingEventName": "govcon-supplier-share-report",
  "newAwards": 3,
  "watchTermHitCount": 1,
  "executiveSummary": {
    "overallStatus": "action_needed",
    "brief": "One monitored feed has a supplier watch-term match."
  },
  "sourceEvidence": [
    "https://ted.europa.eu/..."
  ]
}

There is no published output JSON schema on the Store page.

How is Government Contract Award Change Report priced?

Billing is pay per event. The live Store card is from $4.00 / 1,000 govcon-award-row events ($0.004 each, optional raw rows); $0.12 per govcon-spend-change-alert; $4.00 per govcon-supplier-share-report; $3.00 per govcon-award-export. No Actor Start. Default maxChargeUsd 10. Unchanged runs free. Current PPE:

Event Price Emitted when
govcon-award-row (Government contract award row) $0.004 Charged only when a government contract award row row is delivered.
govcon-spend-change-alert (Government spend change alert) $0.12 Charged only when a government spend change alert row is delivered.
govcon-supplier-share-report (Government supplier share report) $4.00 Charged only when a government supplier share report row is delivered.
govcon-award-export (Government award export) $3.00 Charged only when a government award export row is delivered.

from $4.00 / 1,000 govcon-award-row events ($0.004 each, optional raw rows); $0.12 per govcon-spend-change-alert; $4.00 per govcon-supplier-share-report; $3.00 per govcon-award-export. No Actor Start. Default maxChargeUsd 10. Unchanged runs free.

See Government Contract Award Change Report pricing on Apify

Limits to keep in mind

Open Government Contract Award Change Report on Apify

Related pages