Accessing comprehensive Brazilian holidays data

Developers and companies need reliable data on national, state, and all 5,570 municipal holidays in Brazil for scheduling and automation, but compiling and maintaining it is challenging.

XMar 23ToolDevSource

FL score

out of 100

Verdict

BUILD

high confidence

Competition

competitors found, emerging market, funded players

Trend

No signal yet

An API for comprehensive and accurate Brazilian national, state, and *select* municipal holiday data, targeting developers for critical scheduling and automation.

The pain

Businesses and developers struggle to find 100% accurate, comprehensive holiday data for Brazil, especially at the granular municipal and state levels, leading to operational inefficiencies and errors in scheduling and automation.

The gap

Existing generic holiday APIs lack municipal-level detail, and even Brazil-specific solutions have perceived gaps in 100% accuracy, stability, or cost for truly comprehensive coverage. The gap is for a highly reliable, accurate, and consistently maintained API for this niche.

Build angle

Instead of aiming for all 5,570 municipalities initially, focus on delivering unparalleled accuracy and stability for national, state, and a prioritized list of the top 50-100 most economically significant or highly requested municipalities. Gradually expand coverage based on user demand and revenue.

Strengths

Real, specific pain point for developers and businesses.
Clear signals of willingness to pay for accurate data.
Growing market for precise scheduling and automation data.
Clear path to monetization via API subscriptions.
Data asset could provide a long-term moat if accuracy is maintained.

Risks

The initial ambition of 'all 5,570 municipal holidays' is a massive data collection and maintenance challenge for a solo builder.
Moderately competitive market with existing Brazil-focused and funded general holiday APIs.
Achieving and *sustaining* 100% accuracy across thousands of municipalities is extremely difficult.
High operational overhead for data maintenance could become a burden.
Risk of being 'yet another API' if the accuracy/completeness claim isn't demonstrably superior.

Next steps

Conduct in-depth interviews with developers/companies managing operations in Brazil to identify the *most critical* states/municipalities for holiday data and specific pain points with existing solutions.
Validate the pricing sensitivity for 'guaranteed accuracy and specific municipal coverage' beyond what current freemium models offer.
Build an MVP for national and state holidays + 5-10 highly requested major cities. Focus on proving the '100% accurate' claim for this smaller scope.
Research the best automated and manual methods for sourcing and verifying municipal holiday data and estimate the ongoing maintenance effort for expanded coverage.

Fly Labs Method

Is the pain real, is there a gap, is it the right time, can one person build it.

Problem clarity: 25
Solution gap: 15
Willingness to pay: 18
Buildability: 10

The problem of comprehensive, accurate Brazilian holiday data is real and specific, with clear payment signals, but the competitive landscape is moderate and the scope of '5,570 municipal' makes it very difficult for a solo builder.

Value Equation

Dream outcome and how likely it feels, against the time and effort it costs.

Good market pain and potential outcome, but the complexity of achieving the 'comprehensive' vision for 5,570 municipalities and competing in a moderately crowded space significantly reduces its attractiveness for a solo builder.

One-Person Business

Curiosity pull, identity fit, and a path from free value to paid for a solo creator.

Clear problem and monetization path, but the operational complexity and lack of natural creator fit for a solo builder trying to cover 'all 5,570' municipalities severely limit its viability.

Viral Frameworks

Hook strength, shareability, and how cheaply it can be tested.

A clear value proposition and target audience, but the ambition to cover all 5,570 municipalities introduces significant assumption risks and makes comprehensive validation impractical for a solo builder.

Builder Lens

Evidence the problem exists, timing, defensibility, and a model that fits on a napkin.

Strong demand and clear pain, but the '5,570 municipal' scope makes the narrowest wedge challenging to define and execute for immediate impact as a solo builder.

Why this verdict

The core problem is real and there's a clear willingness to pay for a better solution, particularly for granular municipal data. However, the proposed scope of 'all 5,570 municipal holidays' presents an enormous, likely unsustainable, challenge for a solo builder, especially in a moderately competitive market. The 'buildability' and 'assumption risk' scores are low due to this. The idea needs to be significantly de-risked and narrowed to be viable for a solo builder. Focusing on a smaller, high-demand subset of municipalities and proving superior accuracy/stability there first is crucial before attempting broader coverage. This reduces the immediate build complexity and allows for focused validation against the most pressing user complaints.

Five lenses, one composite. How scoring works

The angle

This weekend

Conduct in-depth interviews with developers/companies managing operations in Brazil to identify the *most critical* states/municipalities for holiday data and specific pain points with existing solutions.
Validate the pricing sensitivity for 'guaranteed accuracy and specific municipal coverage' beyond what current freemium models offer.
Build an MVP for national and state holidays + 5-10 highly requested major cities. Focus on proving the '100% accurate' claim for this smaller scope.
Research the best automated and manual methods for sourcing and verifying municipal holiday data and estimate the ongoing maintenance effort for expanded coverage.

Who is already there, emerging market

Feriados API (Smithery)Visit
Provides real-time Brazilian national, state, and municipal holidays data through an MCP server for AI agents and workflows.
Pricing: Offers a free account with 100 requests/month; API key required for access.
CalendarificVisit
Offers a global holiday JSON API with comprehensive holiday data and business hours for over 230 countries, including national and religious holidays.
Pricing: 1000 requests/month free tier; paid plans available (specific numbers not found in search results, but referred to as 'Enterprise platform').
HolidayAPI.comVisit
Provides holiday data with a focus on accuracy for various countries worldwide.
Pricing: Freemium, Basic plan is free with a quota of 100 requests; overages extra.
AbstractAPI Public HolidaysFundedVisit
Offers an API for national, regional, and religious holiday data.
Pricing: 1000 requests/month free tier.
OpenHolidays APIVisit
A small Open Data project collecting public and school holiday data via an open REST API, supporting Brazil (public holidays from 2020).
Pricing: Free (Open Data project).
BrasilAPI HolidaysVisit
A client for BrasilAPI Holidays endpoints, providing functions to fetch information about Brazilian national holidays for a specific year, including movable holidays.
Pricing: Free (implied for an open API).
Brazil Holidays API (Zyla API Hub)Visit
Focuses specifically on Brazil, providing accurate and up-to-date information about public holidays across the country, including by state and city.
Pricing: Not explicitly stated but compared against 'Check Holidays API' which generally offers free tiers and paid plans.

Funded players

What they charge

The pricing landscape for holiday APIs generally includes free tiers with limited requests (e.g., 100-1000 requests/month) and then moves to paid plans, often with custom or tiered pricing for higher volumes and advanced features. Some open-source or open-data projects offer free access. Enterprise pricing is typically available for solutions offering extensive coverage, high reliability, and additional features like local/municipal holidays.

Accessing comprehensive Brazilian holidays data

Excessive CAPTCHA challenges degrading GitHub login UX for enterprise users

GTA modders tediously manually edit assembly files for modpacks

BreezePDF – Free, in-browser PDF editor