Public Holiday API Scraper

What it does

Get public holidays for any country and year using the Nager.Date API. Extract holiday names, dates, types, and country info. Free public API, no authentication.

This actor connects to a public data source, fetches structured data based on your search criteria, and stores the results in a clean, normalized dataset on the Apify platform. It handles pagination automatically so you can collect large volumes of results without worrying about API limits or offsets. The actor is designed to be robust with built-in error handling, request timeouts, and input validation to ensure reliable data collection every time you run it.

Why use this actor

Manually querying APIs and handling pagination, rate limits, and data normalization is tedious and error-prone. This actor automates the entire process. Simply provide your search parameters, set the maximum number of results you want, and let the actor handle the rest. The data is stored in a structured dataset that you can export as JSON, CSV, or Excel. You can integrate this actor into larger workflows using the Apify API, schedule it for recurring data collection, or trigger it from your own applications via webhooks.

Input parameters

• searchQuery (string, required): Country code (e.g., US, GB, DE, FR, JP). Default: "US".
• maxResults (integer, optional): Maximum number of results to return. Default: 50. Range: 1-100.

All inputs are validated at startup with sensible defaults applied when values are missing. The actor will log warnings for any misconfigured options and continue with safe defaults rather than failing outright.

Output data

Each result in the dataset contains the following fields:

• title: Holiday Name of the result
• url: Info URL of the result
• date: Date of the result
• country: Country of the result
• position: Position of the result
• searchQuery: Country Code of the result

All string fields are null-checked to ensure consistent data quality. Missing or undefined values are stored as null rather than empty strings or undefined values.

Example output

{
    "title": "Example Holiday Name",
    "url": "Example Info URL",
    "date": "Example Date",
    "country": "Example Country",
    "position": 42,
    "searchQuery": "Example Country Code"
}

Pricing

This actor is available on the Apify platform with transparent usage-based pricing. Each run incurs a small startup cost of approximately $0.005 per start, plus roughly $0.01 per result collected. Actual costs depend on the number of results, API response times, and memory allocation. You can control costs by setting the maxResults parameter to limit the number of results collected per run. For high-volume use cases, consider running the actor on a schedule during off-peak hours to optimize platform resource usage.

Related scrapers

Explore these related actors from brave_paradise:

• REST Countries Data
• World Bank Indicator

More scrapers from brave_paradise

Check out other data collection actors by brave_paradise on the Apify Store. We offer a wide range of specialized data scrapers and automation tools covering research databases, package registries, job boards, and many more public data sources. Each actor is designed with the same high-quality standards: robust error handling, automatic pagination, clean structured output, and transparent pricing.

Visit the brave_paradise profile on Apify to explore the full collection.