Get public holidays by country and year with a free API

Public holidays can be a crucial aspect of any application that deals with dates and calendars. Whether it's a calendar app, an event planner, or even a social media platform, being able to fetch public holidays by country and year is essential for accuracy and completeness.

However, finding reliable APIs that provide this functionality can be a challenge. Many APIs focus on financial calculations or image generation, leaving developers scrambling to find the perfect fit.

That's where the Finance, Holidays & OG Image Tools API comes in. This comprehensive API not only provides public holidays by country and year but also offers loan and compound-interest calculators, as well as dynamic Open Graph social-image generation. The best part? It's all wrapped up in a lightweight and easy-to-use interface.

One of the most significant advantages of this API is its breadth of coverage. With support for over 150 countries, you can be confident that your application will have access to the public holidays data it needs. Whether you're building a global app or targeting a specific region, this API has got you covered.

But what does a typical request and response look like? In simple terms, when you make a request to the API, you'll provide some basic parameters such as the country code and year. The API will then return a JSON object containing the relevant public holidays data for that specific time period.

The response is straightforward and easy to parse. You can expect to receive an array of objects, each representing a single holiday. These objects typically contain fields like the holiday name, date range, and even notes or explanations about why the holiday is observed in a particular country.

Here's an example of what this might look like:

• A JSON object containing public holidays for January 2024 in Japan
  • { "date_ranges": [ {"start_date": "2024-01-01", "end_date": "2024-01-03"}, {"start_date": "2024-04-29", "end_date": "2024-05-03"} ] } }

By providing this data, the API helps you avoid errors and inaccuracies that could arise from manually guessing or looking up public holidays.

If you're a developer looking for a reliable and comprehensive solution to fetch public holidays by country and year, we highly recommend checking out the Finance, Holidays & OG Image Tools API. Its free tier is available on RapidAPI, which means you can try it out without incurring any costs. By signing up and trying this API, you'll be able to add accurate and reliable public holiday data to your application with ease.

In short, with its comprehensive coverage, lightweight interface, and easy-to-use parameters, the Finance, Holidays & OG Image Tools API is a must-have for developers and indie makers looking to enhance their applications with reliable public holiday data.

Quick example

curl -X GET 'https://finance-holidays-and-og-image-tools.p.rapidapi.com/holidays?country=US&year=2026' \
  -H 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  -H 'X-RapidAPI-Host: finance-holidays-and-og-image-tools.p.rapidapi.com'

Try it: the Finance, Holidays & OG Image Tools API is live on RapidAPI with a free tier — get your key here.