# HolidayFYI

> Comprehensive holiday and celebration reference covering 50 holidays across 50 countries, 200 guides, 120 glossary terms, 40 cultural traditions, 25 holiday comparisons, 10 world religions, 8 seasonal pages, 30 notable weeks, 105 blog articles, and 15 interactive tools including holiday countdown, bridge-day calculator, and long weekend planner. Calendar dates, iCal feeds, and RSS available.

## Data Scope
- 50 major holidays from around the world with dates, history, and customs
- 50 countries with public holiday schedules and annual calendars
- Holiday × Country pages (how each holiday is celebrated per country)
- Holiday × Year pages (dates for specific years)
- 200 educational guides on holiday traditions, cultural practices, and calendar systems
- 120 glossary terms for holiday and calendar terminology
- 40 cultural traditions from diverse regions and civilizations
- 25 holiday comparison pages (side-by-side analysis)
- 10 world religion profiles with associated holidays
- 8 seasonal pages (spring, summer, autumn, winter + equinox/solstice)
- 30 notable weeks (awareness weeks, cultural celebrations)
- 105 blog articles on holiday topics
- Calendar date pages with holidays, seasons, and notable events
- Long weekend planner by country and year
- Bridge-day calculator for maximizing vacation days
- iCal feeds per country and per holiday
- RSS/Atom feeds for upcoming holidays and blog
- 15 languages: en, ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/` — Homepage — today's holidays, upcoming celebrations (e.g. `/`)
- `/today/` — Holidays happening today worldwide (e.g. `/today/`)
- `/holiday/{slug}/` — Holiday detail with history, customs, dates (e.g. `/holiday/christmas/`)
- `/holiday/{slug}/{year}/` — Holiday dates for a specific year (e.g. `/holiday/christmas/2026/`)
- `/holiday/{holiday}/{country}/` — Holiday in a specific country (e.g. `/holiday/christmas/germany/`)
- `/country/` — Browse all 50 countries (e.g. `/country/`)
- `/country/{slug}/` — Country detail with public holidays (e.g. `/country/united-states/`)
- `/country/{slug}/{year}/` — Country holidays for a specific year (e.g. `/country/united-states/2026/`)
- `/guide/` — Browse all 200 guides (e.g. `/guide/`)
- `/guide/{slug}/` — Guide article (e.g. `/guide/history-of-easter/`)
- `/glossary/` — Holiday terminology glossary (120 terms) (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term detail (e.g. `/glossary/solstice/`)
- `/tradition/` — Browse 40 cultural traditions (e.g. `/tradition/`)
- `/tradition/{slug}/` — Tradition detail (e.g. `/tradition/hanami/`)
- `/compare/` — Browse 25 holiday comparisons (e.g. `/compare/`)
- `/compare/{slug}/` — Holiday comparison detail (e.g. `/compare/christmas-vs-hanukkah/`)
- `/season/` — Browse 8 seasons (e.g. `/season/`)
- `/season/{slug}/` — Season detail with holidays (e.g. `/season/spring/`)
- `/week/` — Browse 30 notable weeks (e.g. `/week/`)
- `/week/{slug}/` — Notable week detail (e.g. `/week/golden-week/`)
- `/long-weekends/{country}/{year}/` — Long weekends for a country in a year (e.g. `/long-weekends/united-states/2026/`)
- `/tool/` — Browse 15 interactive tools (e.g. `/tool/`)
- `/tool/{slug}/` — Tool page (e.g. `/tool/holiday-countdown/`)
- `/tool/bridge-day-calculator/{country}/` — Bridge-day calculator for a country (e.g. `/tool/bridge-day-calculator/germany/`)
- `/tool/bridge-day-calculator/{country}/{year}/` — Bridge days for a country and year (e.g. `/tool/bridge-day-calculator/germany/2026/`)
- `/calendar/` — Calendar index (e.g. `/calendar/`)
- `/calendar/{year}/` — Year calendar with holidays (e.g. `/calendar/2026/`)
- `/calendar/{year}/{month}/` — Month calendar (e.g. `/calendar/2026/january/`)
- `/calendar/{year}/q{quarter}/` — Quarter calendar (e.g. `/calendar/2026/q1/`)
- `/calendar/{year}/week/{week}/` — Week calendar (e.g. `/calendar/2026/week/1/`)
- `/calendar/day/{slug}/` — Calendar date detail (e.g. `/calendar/day/2026-01-01/`)
- `/blog/` — Holiday articles and stories (105) (e.g. `/blog/`)
- `/blog/{slug}/` — Blog article detail (e.g. `/blog/history-of-new-year/`)
- `/search/` — Search holidays, countries, guides (e.g. `/search/?q=easter`)

## Holidays & Countries
- [Today's Holidays](https://holidayfyi.com/today/)
- [Browse All Countries (50)](https://holidayfyi.com/country/)
- [Holiday Calendar](https://holidayfyi.com/calendar/)

## Cultural Content
- [Guides — 200 Educational Articles](https://holidayfyi.com/guide/)
- [Traditions — 40 Cultural Practices](https://holidayfyi.com/tradition/)
- [Comparisons — 25 Holiday Face-Offs](https://holidayfyi.com/compare/)
- [Seasons — Spring, Summer, Autumn, Winter](https://holidayfyi.com/season/)
- [Notable Weeks (30)](https://holidayfyi.com/week/)

## Interactive Tools (15)
- [Holiday Countdown](https://holidayfyi.com/tool/holiday-countdown/)
- [Bridge-Day Calculator](https://holidayfyi.com/tool/bridge-day-calculator/)
- [Long Weekend Planner](https://holidayfyi.com/tool/long-weekend-planner/)
- [Holiday Finder by Date](https://holidayfyi.com/tool/holiday-finder-by-date/)
- [Holiday Calendar Export (iCal)](https://holidayfyi.com/tool/holiday-calendar-export/)
- [Holiday Travel Planner](https://holidayfyi.com/tool/holiday-travel-planner/)
- [Holiday Quiz](https://holidayfyi.com/tool/holiday-quiz/)
- [Holiday World Map](https://holidayfyi.com/tool/holiday-world-map/)
- [Holiday Timeline](https://holidayfyi.com/tool/holiday-timeline/)
- [Public Holiday Checker](https://holidayfyi.com/tool/public-holiday-checker/)
- [Cultural Etiquette Guide](https://holidayfyi.com/tool/cultural-etiquette-guide/)

## Reference
- [Glossary — Holiday Terminology (120 terms)](https://holidayfyi.com/glossary/)
- [Blog — 105 Articles](https://holidayfyi.com/blog/)
- [Subscribe (RSS/Atom/iCal)](https://holidayfyi.com/subscribe/)

## Embed Widget
- [HolidayFYI Widget Docs](https://widget.holidayfyi.com)
- [holidayfyi-embed on npm](https://www.npmjs.com/package/holidayfyi-embed)
- [holidayfyi-embed on GitHub](https://github.com/fyipedia/holidayfyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/holidays/` | List all holidays |
| GET | `/api/v1/holidays/{slug}/` | Holiday detail |
| GET | `/api/v1/countries/` | List all countries |
| GET | `/api/v1/countries/{slug}/` | Country detail |
| GET | `/api/v1/countries/{slug}/holidays/` | Country holidays list |
| GET | `/api/v1/today/` | Holidays happening today |
| GET | `/api/v1/upcoming/` | Upcoming holidays |
| GET | `/api/v1/instances/` | Holiday instances (dated occurrences) |
| GET | `/api/v1/calendar/` | Calendar data |
| GET | `/api/v1/glossary/` | Glossary terms |
| GET | `/api/v1/glossary/{slug}/` | Glossary term detail |
| GET | `/api/v1/guides/` | Guides list |
| GET | `/api/v1/guides/{slug}/` | Guide detail |
| GET | `/api/v1/traditions/` | Traditions list |
| GET | `/api/v1/traditions/{slug}/` | Tradition detail |
| GET | `/api/v1/comparisons/` | Comparisons list |
| GET | `/api/v1/tools/` | Tools list |
| GET | `/api/v1/seasons/` | Seasons list |
| GET | `/api/v1/weeks/` | Notable weeks list |
| GET | `/api/v1/blog/` | Blog posts list |
| GET | `/api/v1/faqs/` | FAQs list |
| GET | `/api/v1/bridge-days/` | Bridge-day calculation |
| GET | `/api/v1/search/` | Search holidays, countries, glossary |
| GET | `/api/v1/stats/` | Site statistics |

```bash
curl -s "https://holidayfyi.com/api/v1/today/"
```

[API Docs](https://holidayfyi.com/developers/) · [OpenAPI Spec](https://holidayfyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install holidayfyi` — [holidayfyi](https://pypi.org/project/holidayfyi/) — Holiday dates, Easter calculation, 200+ countries (v0.1.2)
- **npm**: `npm install holidayfyi` — [holidayfyi](https://www.npmjs.com/package/holidayfyi) — TypeScript holiday utilities (v0.1.1)
- **Embed Widget**: [holidayfyi-embed](https://widget.holidayfyi.com)

## Utility FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [UnitFYI](https://unitfyi.com) — 220 units, 20 categories, Decimal precision
- [TimeFYI](https://timefyi.com) — Timezone ops, business hours, sunrise/sunset
- [NameFYI](https://namefyi.com) — Korean romanization, Five Elements, CJK strokes

## Images (CDN)

OG images at https://cdn.holidayfyi.com/og/
- https://cdn.holidayfyi.com/og/homepage.png

## Full Index
- [Full content index](https://holidayfyi.com/llms-full.txt)
- [XML Sitemap](https://holidayfyi.com/sitemap.xml)