← Intelligence Mashups

Festival & Event Finder

GET /mashup/festival/finder

Discover upcoming festivals and events: combines public holidays, shopping events, weather forecasts, and country data for any country. Filter by how far ahead to look.

Parameters

country required

Country code

months optional

Months ahead to search (default 3)

Example Requests

Basic usage
curl "https://nordapi.ee/api/v1/mashup/festival/finder?country=EE&months=6"

Live Response 

{
  "country": "EE",
  "country_name": null,
  "generated_at": "2026-08-12T08:05:39.542767Z",
  "months_ahead": 6,
  "public_holidays": [
    {
      "date": "2026-08-20",
      "name": "Day of Restoration of Independence",
      "type": "Public"
    },
    {
      "date": "2026-12-24",
      "name": "Christmas Eve",
      "type": "Public"
    },
    {
      "date": "2026-12-25",
      "name": "Christmas Day",
      "type": "Public"
    },
    {
      "date": "2026-12-26",
      "name": "St. Stephen's Day",
      "type": "Public"
    },
    {
      "date": "2027-01-01",
      "name": "New Year's Day",
      "type": "Public"
    }
  ],
  "shopping_events": [
    {
      "category": "ecommerce",
      "date": "2026-11-11",
      "name": "Singles' Day (11.11)"
    },
    {
      "category": "ecommerce",
      "date": "2026-11-27",
      "name": "Black Friday"
    },
    {
      "category": "ecommerce",
      "date": "2026-11-30",
      "name": "Cyber Monday"
    },
    {
      "category": "promotional",
      "date": "2026-12-01",
      "name": "Giving Tuesday"
    },
    {
      "category": "seasonal",
      "date": "2026-12-01",
      "name": "Christmas Sales Season"
    },
    {
      "category": "seasonal",
      "date": "2026-12-26",
      "name": "End of Year Sales"
    },
    {
      "category": "seasonal",
      "date": "2027-01-01",
      "name": "New Year's Sales"
    }
  ],
  "success": true,
  "weather_forecast": null
}
← Back to Intelligence Mashups