Current endpoint
Events intelligence
Source-backed city event signals with travel pressure, hotel pressure, crowd pressure, parsed date windows, booking guidance and trip context.
GET /api/intelligence/eventsHolidace Intelligence
Holidace turns city timing data into queryable intelligence for machines: events, crowds, hotel pressure, parsed date windows, booking windows and source-backed travel context.
Current endpoint
Source-backed city event signals with travel pressure, hotel pressure, crowd pressure, parsed date windows, booking guidance and trip context.
GET /api/intelligence/eventsDesigned for
Response fields
The Events API returns structured fields that help machines explain why a date may be busier, more booking-sensitive or better suited to a specific trip. Parsed date windows are included only when the source text can be normalized safely.
Filters
Use filters to narrow event intelligence by city, category, impact, pressure level or booking window.
city=sydneyFilter by city name or city slug.
category=musicFilter by event category.
impact=highFilter by event impact: low, medium or high.
pressure=highFilter by travel pressure label.
booking_window=book_very_earlyFilter by booking guidance: flexible, monitor, book_early or book_very_early.
limit=10Limit response size. Current maximum is 100 records.
Example response
The API includes pressure reasoning, parsed dates when safe, traveler fit and booking-window guidance. Pricing percentages are excluded until real sampled data is available.
{
"data_version": "city_event_signals_v1",
"intelligence_level": "event_pressure_enriched_v1",
"pricing_note": "Pricing percentages are not included until real published samples exist.",
"date_note": "starts_on and ends_on are only populated when the source date text can be parsed safely.",
"example_request": "/api/intelligence/events?city=sydney&pressure=high&booking_window=book_early&limit=1",
"applied_filters": {
"city": "sydney",
"pressure": "high",
"booking_window": "book_early",
"limit": 1
},
"count": 1,
"records": [
{
"event_name": "Sydney Festival",
"city_name": "Sydney, Australia",
"dates": "Jan 8-26",
"starts_on": "2026-01-08",
"ends_on": "2026-01-26",
"event_year": 2026,
"date_precision": "confirmed_range",
"date_parse_status": "parsed",
"date_parse_note": "parsed confirmed same-month range",
"category": "cultural",
"event_category_raw": "cultural",
"event_category_normalized": "arts_culture",
"event_category_confidence": "medium",
"event_category_reason": "Matched arts, culture, heritage or festival terms.",
"impact": "high",
"travel_pressure_score": 88,
"travel_pressure_label": "high",
"hotel_pressure_label": "likely_high",
"crowd_pressure_label": "likely_high",
"pressure_reason": "High-impact event signal with likely hotel and crowd pressure during a major city festival window.",
"booking_window": {
"label": "book_early",
"days_min": 30,
"days_max": 90
},
"good_for": [
"culture travelers",
"planned city breaks"
],
"avoid_if": [
"low-crowd trips",
"last-minute central hotels"
],
"stay_strategy": "Book stays early and compare neighborhoods if central hotels are limited.",
"transport_warning": "Expect busier streets, venues and local transport around the main event window.",
"pricing_status": "not_sampled",
"source_name": "Sydney Festival"
}
]
}The current endpoint is public for discovery and testing. Future partner data access may include higher limits, additional city coverage, OpenAPI schemas, usage support and commercial licensing.