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
- Award/incumbent watches
- Supplier-share reports
- USASpending agency award feeds
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
- Unofficial; not bid advice
- SAM optional key
- TED/USASpending key-free
- Does not submit bids
- Respect source terms, robots.txt, and rate limits.
Open Government Contract Award Change Report on Apify
Related pages
- TED, SAM.gov & Grants Bid Alerts — Pre-award notices; this Actor is post-award changes.
- Campaign Finance Scraper — FEC/LDA, not TED/USASpending awards
- HTS Tariff & Trade Scraper — HTS/USTR, not contract awards
- Grants.gov Scraper — Open Grants.gov notices, not awarded contracts
- SAM.gov Vendor Pursuit Intelligence — keyword opportunity scrape.
- Public RFP Rebid Watch Report — snapshot and rebid timing.
- Public Vendor Registry Intelligence — supplier portal pages you list.
- GovCon Recompete & Spend Shift Watch — award windows and concentration.
- Tools