API Key Configuration

Enter your API keys below. Each key unlocks an additional data source. The system works with just one key — add more to improve forecast accuracy.
Keys are saved to your .env file on the server. Restart after saving.

Loading…
Event Sources
TICKETMASTER_API_KEY
Concerts, sports, shows. Core event feed.
Get free key →
Required
PREDICTHQ_TOKEN
Community events, festivals, holidays, attendance data.
Get free key →
Recommended
SEATGEEK_CLIENT_ID
Concerts, sports, theater — strong EU coverage. Good Ticketmaster alternative.
Get free key →
Optional
SONGKICK_API_KEY
Music concerts, tours, festivals globally. Fills gaps in music events.
Get free key →
Optional
BANDSINTOWN_APP_ID
Indie and smaller gigs not on Ticketmaster. Use any name as app ID (e.g. hawk-hospitality).
Free — no signup →
Optional
FOOTBALL_DATA_TOKEN
European football fixtures — Eredivisie, Premier League, Bundesliga, La Liga, Serie A. Matches drive major demand spikes 1–2h before kick-off.
Get free token (1 min) →
Recommended
DICE_API_KEY
Club nights, live shows, electronic music — Amsterdam, Berlin, London, Barcelona. Requires applying to the DICE partner programme first.
Apply for partner access →
Optional
Weather & Real-Time Signals
OPENWEATHER_API_KEY
Rain cuts nightlife -20%. Clear & warm adds +12%.
Get free key →
Recommended
GOOGLE_PLACES_API_KEY
Venue density signal — how many good bars are nearby. Averaged with Foursquare when both are set.
Enable Places API →
Optional
FOURSQUARE_API_KEY
Second venue density source — averaged with Google Places for a more balanced ambient score. Free 500 calls/day.
Get free key →
Optional
TWITTER_BEARER_TOKEN
Real-time social buzz. Detects when an area is getting busy now.
Get Bearer Token →
Optional
Map
MAPBOX_TOKEN
Interactive heatmap in the dashboard. Required for the map to render.
Get free token →
Recommended
Database & Email
DATABASE_URL
PostgreSQL for multi-tenant key management. Leave empty for single-user dev mode.
Optional
RESEND_API_KEY
Sends API keys by email on signup. Free: 3k/month.
Get free key →
Optional
Locale
VENUE_COUNTRY
Country for public holiday calendar. Default: NL (Netherlands).
Optional
Open Dashboard →
After saving: Restart the server for changes to take effect.
uvicorn hospitality_intelligence.main:app --reload

Never share your .env file. It contains secret keys. The setup page only runs locally — it is not accessible from the internet unless you explicitly expose it.