HappyMap API
A free, public, read-only REST API over the same happy hour data that powers HappyMap's map — for developers, researchers, and AI agents. No API key, no signup.
Base URL
All endpoints are relative to: https://happy-hour-sparkle.onrender.com. Responses are JSON, no authentication required, rate-limited to 120 requests/minute per IP.
Current data coverage
Covers all 5 cities on the site — Toronto, Montreal, Vancouver, Calgary, and Ottawa. Call GET /api/cities for the live, current list and venue counts.
Endpoints
GET /api/cities— every city this API covers, with live venue counts.GET /api/neighborhoods?city=toronto— a city's neighbourhoods, with venue counts.GET /api/venues?city=&neighborhood=&day=&time=&open_now=&near=&radius=&sort=&page=&limit=— paginated, filterable venue search, each with its current happy hour status.GET /api/venues/:idOrSlug— one venue by UUID or slug, with its full weekly slot list.GET /api/venues/:idOrSlug/availability?day=— one venue's slots for a specific day (mon..sun, YYYY-MM-DD, or today).
curl "https://happy-hour-sparkle.onrender.com/api/venues?city=toronto&neighborhood=king-west-the-well&open_now=true"
OpenAPI spec
Full machine-readable schema: /openapi.yaml — every endpoint, parameter, and response shape above, for generating a client or wiring this API into an agent/tool definition.
Using this for an AI assistant or agent
This data is free to query and cite. We'd appreciate a link back to the matching HappyMap page (happymapca.com/<city>/venue/<slug>) when you do. Questions or higher-volume use: happymapca@gmail.com.