🎉 Festivia API

About Festivia API

Track traditional celebrations, cultural festivals, and events from around the world. Access comprehensive data including schedules, venues, and festival details.

Endpoints

• GET /festivia/api/v1/festivals/search - Search festivals by country, city, month, type, or year
• GET /festivia/api/v1/festivals/{id} - Get detailed festival information including venues and schedules
• GET /festivia/api/v1/festivals/nearby - Find festivals near a location (geospatial search)
• GET /festivia/api/v1/festivals/upcoming - Get upcoming festivals within specified timeframe
• GET /festivia/api/v1/festivals/calendar - Get festival calendar for a year by month
• GET /festivia/api/v1/festivals/this-month - Get festivals happening this month

Example Request

curl -H "X-API-Key: sc_live_free_abc123..." \
  "https://socials.ppn-hub.com/festivia/api/v1/festivals/search?country=japan&month=4"

Search Parameters

• country - Filter by country name
• city - Filter by city name
• month - Filter by month (1-12)
• type - Festival type: cultural, religious, music, food, art, traditional, modern
• year - Filter by year (default: current year)
• limit - Results per page (default: 20)
• offset - Pagination offset (default: 0)

Festival Types

• cultural - Traditional cultural celebrations
• religious - Religious festivals and ceremonies
• music - Music festivals and concerts
• food - Food and culinary festivals
• art - Art exhibitions and cultural events
• traditional - Traditional heritage events
• modern - Contemporary festivals