What you get
A clean, ready-to-use list of happy hour places: name, address, phone, the deal, the days and hours, what they pour, what they serve, and any coupon or promo code.
Why it is different: you get live happy hour times and working promo codes in one feed — something Google and Yelp do not give you.
Example request
curl "https://happyhour-finder-app.lovable.app/api/v1/happy-hours?lat=34.0522&lng=-118.2437&radius_miles=10&promo_only=true" \
-H "x-api-key: hh_live_your_key_here"Your key goes in the x-api-key header. Nothing else to set up.
Example response
{
"data": [
{
"id": "8f1c...",
"name": "Sunset Rooftop Bar",
"address": "123 Sunset Blvd",
"city": "Los Angeles",
"lat": 34.0983,
"lng": -118.3267,
"deal": "$6 draft beer, $8 house wine",
"days": [1, 2, 3, 4, 5],
"start_time": "15:00",
"end_time": "18:30",
"kid_friendly": false,
"adults_only": true,
"drinks": ["beer", "wine", "cocktails"],
"foods": ["small-plates"],
"phone": "+13235550123",
"promo": "20% off appetizers with code",
"promo_code": "HAPPY20",
"source_url": "https://example-restaurant.com/happy-hour"
}
],
"meta": {
"count": 1,
"radius_miles": 10,
"cached": true,
"attribution": "Happy Hour Finder",
"generated_at": "2026-08-30T23:15:00.000Z"
}
}Filters you can use
- lat, lngWhere to look. Required.
- radius_milesHow far around that spot. Default 10, most 50.
- promo_onlytrue = only places with a real coupon or promo code.
- open_nowtrue = only happy hours running right now.
- day0 to 6, Sunday is 0.
- time24 hour clock, like 17:30.
- limitHow many places to send back. Default 50, most 200.
Want to see where we already have data before you buy? Call /api/v1/coverage with your key.
Pricing
Questions
Email deankozak@pacificdigital1.com.
Terms & Privacy