UK Bank Holidays Scraper

UK Bank Holidays Scraper

Scrape UK bank holidays for England & Wales, Scotland, and Northern Ireland, up to a million per run. Every holiday comes with its date, title, notes, and bunting flag. No login or API key. Export to CSV, JSON, Excel, or XML.

GOV.UK publishes the official bank holiday calendars for England & Wales, Scotland, and Northern Ireland, but there is no public API and the data is spread across separate pages. This Actor reads the public feeds directly, filters by division and year range, and returns each holiday in one fixed schema.

Who uses it	What they scrape GOV.UK Bank Holidays for
HR and payroll teams	Which dates are bank holidays in each UK nation for leave and payroll calculations
Financial services developers	A machine-readable feed of UK bank holidays for settlement and trading calendars
Travel and hospitality businesses	Which long weekends to expect higher demand or plan promotions around
Event planners	Which dates to avoid or target for public events across the UK

What it does

This Actor collects UK bank holidays by division and year range, and returns each one as a flat row.

• 🗂️ Division filter: all divisions, England & Wales, Scotland, or Northern Ireland.
• 📅 Year range: limit results to a specific window from 2010 to 2100.
• 🔢 Maximum holidays: cap the number of results, up to 1,000,000 for paid users.
• 📤 Export formats: CSV, JSON, Excel, or XML.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with GOV.UK Bank Holidays data

📊 Build a payroll calendar.

An HR team runs the Actor for England & Wales and the current year to get every bank holiday date, then feeds the list into their payroll system to avoid paying overtime on public holidays.

📈 Plan trading schedules.

A financial developer scrapes all divisions for the next five years to populate a settlement calendar, ensuring trades are not booked on days when UK markets are closed.

🏨 Forecast travel demand.

A hotel chain runs the Actor for Scotland and Northern Ireland to identify long weekends, then adjusts room pricing and staffing for expected peaks.

📅 Avoid event clashes.

An event planner scrapes all divisions for the next two years to check for bank holiday conflicts before booking venues for conferences and festivals.

Why choose this scraper

	What you get
Official source	Data comes directly from GOV.UK, the authoritative publisher of UK bank holidays.
Nation-specific	Separate calendars for England & Wales, Scotland, and Northern Ireland.
Future-proof	Year range extends to 2100, covering announced holidays far ahead.
Simple schema	Each holiday is a flat row with date, title, notes, and bunting flag.

How it compares

No other Store actor targets GOV.UK Bank Holidays the same way, so the honest comparison is with the alternatives teams actually weigh.

	UK Bank Holidays Scraper	Build it in-house	By hand
Setup	Run it now, zero config	Days of engineering	None, but hours per pull
When GOV.UK Bank Holidays changes	Maintained for you	You fix it	You re-learn the page
Proxies, retries, anti-bot	Built in	Your problem	Browser only
Output	Fixed JSON schema, CSV/Excel export	Whatever you build	Copy-paste
Cost	Pay per result	Engineering time	Analyst hours

Configure the run

Drive the Actor from division and year range, alone or together, and filters run as each holiday is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "maxItems": 10,
  "division": "all-divisions"
}

A larger pull:

{
  "maxItems": 200,
  "division": "all-divisions"
}

Pricing

Pay-per-result: $0.012 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$1.20
1,000 results	$12.00
10,000 results	$120.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the UK Bank Holidays Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to GOV.UK Bank Holidays through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/gov-uk-bank-holidays-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check your year range. If Year From is set after Year To, or if the range is outside 2010 to 2100, no holidays will be returned. Also ensure the division is set correctly.

Why am I only getting 10 items?

Free users are limited to 10 items as a preview. Upgrade to a paid plan to increase the maximum items up to 1,000,000.

Why are Scottish holidays different from England & Wales?

Scotland has its own bank holiday calendar, which includes some dates not observed in England & Wales, such as St Andrew's Day. Select the Scotland division to get the correct list.

Can I get holidays for a specific date range within a year?

The Actor filters by year, not by specific dates. To get a date range, set the year range and then filter the results in your downstream processing.

FAQ

Question	Answer
What is a bank holiday in the UK?	A bank holiday is a public holiday in the United Kingdom when banks and many other businesses are closed. The dates are set by royal proclamation, statute, or custom, and differ between England & Wales, Scotland, and Northern Ireland.
Does this Actor include all UK bank holidays?	Yes, it covers the official bank holidays for England & Wales, Scotland, and Northern Ireland as published by GOV.UK. You can select a specific division or all divisions.
Can I get bank holidays for a specific year?	Yes, use the Year From and Year To inputs to set a range. Leave them empty to include all years available in the feed, from 2010 to 2100.
What data does each holiday include?	Each row includes the holiday date, title, notes (if any), and a bunting flag indicating whether the holiday is marked with bunting on GOV.UK.
Is there a limit on how many holidays I can scrape?	Free users are limited to 10 items as a preview. Paid users can set a maximum up to 1,000,000 items.
How often is the data updated?	The Actor reads the live GOV.UK feeds each time it runs, so you always get the latest published bank holidays.
Can I export the data to Excel?	Yes, you can export the results to CSV, JSON, Excel, or XML directly from the Apify platform.
Do I need an API key or login?	No, the Actor accesses the public GOV.UK feeds directly without any authentication.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by GOV.UK. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.