Pricing

from $5.00 / 1,000 holiday results

Global Public Holidays & Retail Opening Hours API

Extract verified global public holidays, bank holiday trading rules, emergency duty pharmacies, and supermarket opening hours across 50+ countries. Powered by OpenOnHoliday.com.

Pricing

from $5.00 / 1,000 holiday results

Rating

0.0

(0)

Developer

Dario Mory

Actor stats

Bookmarked

Total users

Monthly active users

4 days ago

Last modified

Categories

Travel

Business

E-commerce

You can access the Global Public Holidays & Retail Opening Hours API programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "7f53GMBzvbdRc1MXq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dariomory~global-holiday-opening-hours-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dariomory-global-holiday-opening-hours-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/dariomory~global-holiday-opening-hours-scraper/runs": {
      "post": {
        "operationId": "runs-sync-dariomory-global-holiday-opening-hours-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/dariomory~global-holiday-opening-hours-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-dariomory-global-holiday-opening-hours-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "countries": {
            "title": "Country ISO Codes",
            "type": "array",
            "description": "Filter by 2-letter ISO country codes (e.g. ['us', 'gb', 'de', 'fr', 'it', 'at', 'es', 'nl', 'sg', 'jp', 'in', 'th']). Leave empty for all 50+ countries."
          },
          "year": {
            "title": "Target Year",
            "minimum": 2025,
            "maximum": 2030,
            "type": "integer",
            "description": "Year to fetch public holidays and trading schedules for.",
            "default": 2026
          },
          "categories": {
            "title": "Store / Venue Categories",
            "type": "array",
            "description": "Filter by category (supermarkets, pharmacies, petrol, banks, transit, retail, diy, restaurants, healthcare)."
          },
          "chains": {
            "title": "Specific Chain Slugs",
            "type": "array",
            "description": "Filter by specific brand/chain slugs (e.g. ['lidl', 'aldi', 'dmart', 'walmart', 'costco', 'tesco', 'carrefour', 'esselunga']). Leave empty for all."
          },
          "holidays": {
            "title": "Specific Holiday Slugs",
            "type": "array",
            "description": "Filter by holiday slugs (e.g. ['christmas-day', 'independence-day', 'ferragosto', 'assumption', 'easter-monday']). Leave empty for all."
          },
          "includeEmergencyServices": {
            "title": "Include Emergency Services",
            "type": "boolean",
            "description": "Include 24/7 on-call duty pharmacies, medical hotlines, emergency transit, and 24h petrol stations.",
            "default": true
          },
          "maxItems": {
            "title": "Maximum Output Items",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Maximum number of records to return in the dataset.",
            "default": 500
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Global Public Holidays & Retail Opening Hours API OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Global Public Holidays & Retail Opening Hours API from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Global Public Holidays & Retail Opening Hours API API in Python

Global Public Holidays & Retail Opening Hours API API in JavaScript

Global Public Holidays & Retail Opening Hours API API through CLI

Global Public Holidays & Retail Opening Hours API API

Public Holiday Scraper - Global Holidays by Country

vernacular_reservoir/public-holiday-scraper

Fetch public holidays for 100+ countries worldwide via Nager.Date API. Get holiday name, date, type and regional info. Supports current year, any year from 2000-2030, and upcoming holidays mode. Perfect for HR systems, calendar apps and scheduling tools. No API key required.

Aleksandrs

Public Holidays Scraper

parseforge/nager-public-holidays-scraper

Scrapes public holidays by country and year, available countries, upcoming holidays, or long weekends. Returns each holiday as a flat row with date, local name, English name, and county codes.

ParseForge

Public Holidays Worldwide Scraper

parseforge/public-holidays-scraper

Scrapes public holidays for over 100 countries and any year range. Returns each holiday as a flat row with date, local name, and type.

ParseForge

Public Holidays Scraper

fortuitous_pirate/public-holidays-scraper

Scrape public holidays for any country and year from Nager.Date: 121 countries, 2000+ holidays. Free, no auth required.

Fortuitous Pirate

Public Holidays by Country

lulzasaur/publicholidays-scraper

Get public holidays for any country and year. Holiday names, dates, types, regional coverage. 100+ countries supported. Free Nager.Date API.

lulz bot

Public Holidays Calendar

mangudai/public-holidays-calendar

Official public holidays for 150+ countries and any year. Returns the date, weekday, holiday name and country, with optional localized names and regional holidays. Runs fully offline: no API key, no rate limits, no maintenance.

Mangudäi

South African Public Holidays API — 13 Holidays

sirgrant11788/sa-public-holidays

All 13 SA public holidays.

Grant Verheul

Japan Public Holidays

shiokoshi356/japan-holidays-data

Japan public holidays data. National holidays with dates and names in Japanese and English. Updated annually. MIT licensed open data.

Shiokoshi356

Public Holidays API

easyapi/public-holidays-api

Access holiday data from over 100 countries with our Public Holiday API! Query public holidays and long weekends effortlessly. With an IoT endpoint to check if today is a holiday, it's perfect for developers. Get started today and enhance your applications with up-to-date holiday information!