Uk Contracts Finder Scraper

UK Contracts Finder Scraper collects public procurement notices directly into an Apify dataset that you can export as JSON, CSV, or Excel.

Use cases

• Bid tracking: Pull open contract notices matching keywords like software or technology services.
• Buyer lists: Collect organisation names, postcodes, and contract values from recent awards and live tenders.
• Pipeline watch: Filter by status, type, region, value, or published dates.
• Spreadsheet handoff: Download the dataset as CSV or Excel for your CRM or pipeline review.

Input parameters

Parameter	Type	Default	Description
mode	string	search	search for keyword search, or ocds for feed iteration.
keyword	string	software	Search text for finding relevant notices.
statuses	array	["Open"]	Status filter: Open, Closed, Awarded, Withdrawn.
types	array	["Contract"]	Notice type: Contract, Opportunity, EarlyEngagement, FutureOpportunity.
regions	array	empty	Region names to filter by.
valueFrom	integer	empty	Minimum contract value in pounds.
valueTo	integer	empty	Maximum contract value in pounds.
publishedFrom	string	empty	ISO date or date-time, inclusive.
publishedTo	string	empty	ISO date or date-time, inclusive.
maxItems	integer	100	Row cap (hard maximum 1000).
requestDelaySecs	integer	1	Pause between requests.
timeoutSecs	integer	300	Stop the run after this many seconds.
requestTimeoutSecs	integer	30	Per-request timeout in seconds.
userAgent	string	B2B Lead GenerationActorResearch/1.0	Contact string sent on requests.

Example input

{
  "mode": "search",
  "keyword": "software",
  "types": ["Contract"],
  "statuses": ["Open"],
  "maxItems": 100,
  "requestDelaySecs": 1,
  "timeoutSecs": 300,
  "requestTimeoutSecs": 30,
  "userAgent": ""
}

What data does this actor extract?

Each notice row uses clean field names for easy spreadsheet and database exports:

{
  "id": "25ca0d93-b1f4-420e-8355-c4882a6ffc35",
  "noticeTitle": "CA18471 - Lionheart Educational Trust - HR & Payroll Software and Managed Payroll Services",
  "organisationName": "Lionheart Educational Trust",
  "noticeDescription": "Lionheart Educational Trust is looking for a single supplier for their HR & Payroll Software and Managed Payroll Services requirements.",
  "cpvDescription": "Personnel and payroll services and Payroll management services and Time accounting or human resources software package",
  "publishedDate": "2026-09-17T10:42:12+01:00",
  "deadlineDate": "2026-10-26T10:00:00Z",
  "valueLow": 600000,
  "valueHigh": 600000,
  "postcode": "LE1 6JL",
  "noticeStatus": "Open",
  "noticeType": "Contract",
  "url": "https://www.contractsfinder.service.gov.uk/Notice/25ca0d93-b1f4-420e-8355-c4882a6ffc35",
  "scraped_at": "2026-10-12T00:00:00+00:00"
}

Field	Type	Description
id	string	Notice unique identifier.
noticeTitle	string	Notice title with HTML entities decoded.
organisationName	string	Buyer or organisation name.
noticeDescription	string	Summary or description text.
cpvDescription	string	CPV classification wording.
publishedDate	string	Publication timestamp.
deadlineDate	string	Submission deadline or end date.
valueLow	number	Lower bound value in pounds.
valueHigh	number	Upper bound value in pounds.
postcode	string	Location postcode when available.
noticeStatus	string	Current notice status.
noticeType	string	Notice or opportunity type.
url	string	Direct link to the notice.
scraped_at	string	Timestamp when the row was recorded.

FAQ

How do I export CSV or Excel? Open the run's dataset in Apify and download CSV or Excel directly, or use the dataset output endpoints.

How many notices can one run save? maxItems controls the row cap, defaulting to 100 with a maximum of 1000 per run.

What happens if a request fails? The actor writes an error row with details while allowing successful records to save normally without crashing the run.

---

Trademark Notice

UK Contracts Finder and related names, logos, and trademarks belong to their respective owners. Their use in this documentation is solely to identify the data source and does not imply affiliation or sponsorship.

Disclaimer

This Actor is an independent tool and is not affiliated with or endorsed by UK Contracts Finder or its operators. All data is collected from publicly available sources. Users are responsible for complying with applicable terms and licensing requirements.

Is web scraping legal?

This Actor only collects publicly available data without bypassing any access controls. Scraping public information is generally standard practice, but how you use the data matters:

• Personal data: If results include personal details, applicable privacy regulations such as GDPR or CCPA may apply. Only collect and store personal information when you have a legitimate purpose.
• Copyright: Content such as descriptions or text may be subject to copyright. Avoid republishing full copyrighted materials without permission.
• Terms of use: Respect source guidelines and rate limits.
• Legal advice: This is general information, not legal advice. Consult a professional if you have specific legal questions.

To learn more, read Apify's guide: Is web scraping legal?