UK Contracts Finder OCDS Watchlist Monitor

Monitor UK Contracts Finder public OCDS notices for opportunities, awards, buyers, suppliers, CPV codes, values, SME suitability, deadlines, and source links.

This Actor is for UK government contractors, bid teams, consultants, agencies, market researchers, and sales teams that need repeatable public-sector contract watchlists without scraping the Contracts Finder website.

What It Does

Provide a publication date window and optional filters:

• keywords in title, description, buyer, supplier, or CPV description
• CPV codes or prefixes
• tender statuses such as active or complete
• minimum GBP value
• SME-suitable notices only

The Actor calls the public Contracts Finder OCDS endpoint, normalizes releases into one row per notice, and compares against previous runs so schedules can emit only new matches.

Output

Each result is one UK Contracts Finder notice:

{
  "recordType": "uk_contracts_finder_notice",
  "changeType": "new_notice",
  "ocid": "ocds-b5fd17-demo",
  "title": "Cloud migration support for local authority",
  "buyerName": "Demo Council",
  "publishedAt": "2026-05-12T09:00:00+01:00",
  "deadlineDate": "2026-06-15T12:00:00+01:00",
  "status": "active",
  "cpvCode": "72000000",
  "valueAmount": 150000,
  "valueCurrency": "GBP",
  "smeSuitable": true,
  "sourceUrl": "https://www.contractsfinder.service.gov.uk/Notice/demo"
}

The run also stores:

• RUN_SUMMARY with source status, counts, and errors
• CONTRACT_EXPORT with all emitted records
• NEW_ONLY for scheduled alert workflows
• BUYER_BRIEF for a short reviewable report
• SLACK_ALERTS for webhook-style notification payloads

Pricing

Dry runs are free. Live runs use Pay per Event:

• first 25 live matches are free for Apify free-plan users
• then $0.004 per emitted UK contract notice match

This charges only when a notice matches the user's watchlist and is emitted.

Limits And Compliance

This Actor uses public Contracts Finder OCDS data under the Open Government Licence. OCDS fields vary by notice type and buyer. Verify bid-critical decisions against the source notice and procurement documents.

This Actor is not procurement, legal, or bid advice.

Example Input

{
  "publishedFrom": "2026-05-01",
  "keywords": ["cloud", "software"],
  "cpvCodes": ["72000000"],
  "statuses": ["active"],
  "minValueGbp": 50000,
  "smeOnly": true,
  "maxResults": 25,
  "compareToPreviousRun": true,
  "includeUnchanged": false,
  "dryRun": false
}

Good Use Cases

• UK public-sector opportunity monitoring
• CPV-specific bid alerts
• SME-suitable contract discovery
• buyer and supplier market research
• award tracking for competitor intelligence
• procurement datasets for Sheets, BI, CRM, and AI workflows

Local Development

npm install
npm test
npm run build
APIFY_LOCAL_STORAGE_DIR=./storage APIFY_INPUT='{"dryRun":true}' npm start