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.