Nearest shops, live
/v1/hotlight returns the nearest shops that have a Hot Light, nearest first, each with hot_now, hot_since, next_hot_window, posted windows, open status, address and coordinates.
Live · API / 02 · Food & Location
Is the Hot Light on at the doughnut shop near me? Send a latitude and longitude and get the nearest shops with live Hot Light status, since when the light has been on, and when the next window starts. Refreshed every minute, nationwide, as plain JSON.
01 Overview
Hot Light Radar watches publicly available shop information across the US, keeps a fresh snapshot, and answers location queries from that snapshot in milliseconds. Build a "hot doughnuts now" alert, a car or phone notification, a smart-home light, a map layer or a widget.
/v1/hotlight returns the nearest shops that have a Hot Light, nearest first, each with hot_now, hot_since, next_hot_window, posted windows, open status, address and coordinates.
/v1/hotlight/next returns the nearest lit shop, or the shop whose next window starts soonest. Built for alerts.
/v1/hotlight/active lists every shop whose light is on, nationwide or within a radius.
Get a signed POST to your own URL the moment a Hot Light turns on or off, for one shop or for everything near a point.
Every response carries as_of and data_age_seconds, and sets stale: true if the snapshot is more than five minutes old.
The Basic plan is free with 500 requests a month and every read endpoint. Paid plans add volume and webhooks.
Good to know Not every shop has a Hot Light. Many city storefronts, airport and casino locations are skipped by the location endpoints and show has_hot_light: false when looked up by id. Distance is straight-line, not drive time.
02 Quick start
You are at latitude 36.1, longitude -80.25. Which nearby shops have a Hot Light, and is any of them on?
01 Subscribe on RapidAPI (the Basic plan is free) and copy your API key.
02 Ask for the three nearest shops:
curl --request GET \
--url 'https://hot-light-radar-doughnut-shop-status.p.rapidapi.com/v1/hotlight?lat=36.1&lng=-80.25&count=3' \
--header 'X-RapidAPI-Key: YOUR_KEY' \
--header 'X-RapidAPI-Host: hot-light-radar-doughnut-shop-status.p.rapidapi.com'const params = new URLSearchParams({ lat: "36.1", lng: "-80.25", count: "3" });
const res = await fetch(`https://hot-light-radar-doughnut-shop-status.p.rapidapi.com/v1/hotlight?${params}`, {
headers: {
"X-RapidAPI-Key": "YOUR_KEY",
"X-RapidAPI-Host": "hot-light-radar-doughnut-shop-status.p.rapidapi.com",
},
});
const data = await res.json();
const lit = data.shops.find((shop) => shop.hot_now);
console.log(lit ? `Hot now: ${lit.name}` : "No Hot Light on nearby");03 Read the answer (response abridged):
{
"query": { "lat": 36.1, "lng": -80.25 },
"as_of": "2026-10-12T12:04:28.571Z",
"data_age_seconds": 4,
"stale": false,
"shops": [
{
"shop_id": 101,
"name": "Winston Salem - S Stratford Rd",
"address": "259 S Stratford Road, Winston-Salem, NC 27103",
"hot_now": true,
"hot_since": "2026-10-12T12:04:28.571Z",
"next_hot_window": { "start": "2026-10-12T11:00:00.000Z", "end": "2026-10-12T13:00:00.000Z" },
"hot_windows": ["7:00 AM - 9:00 AM", "5:00 PM - 7:00 PM"],
"open_now": true,
"distance_miles": 1.8
}
]
}hot_now is the live status. The posted hot_windows are only a guide: some shops light up early and some stay dark during their window. Use hot_now for "is it on" and the windows for "when might it be".hot_since means "since we first saw it lit", not the exact moment the light came on.03 Endpoints
Plain JSON with consistent field names. Every call to any endpoint counts as one request.
| Endpoint | What it does |
|---|---|
GET /v1/hotlight | The nearest shops with a Hot Light, nearest first, with live status. Params: lat, lng, optional count. |
GET /v1/hotlight/next | The nearest lit shop, or the shop whose next window starts soonest. Built for alerts. |
GET /v1/hotlight/active | Every shop whose Hot Light is on right now, nationwide or within a radius. |
GET /v1/shop/{shopId} | One shop's status and schedule by id. |
POST /v1/webhooks | Subscribe to Hot Light changes. Follow one shop with shop_id, or a point with lat and lng (the single nearest shop, or every shop within radius_miles). events is on, off or both. Pro plan and above. |
GET /v1/webhooks | List your subscriptions. GET and DELETE /v1/webhooks/{id} read or remove one. |
POST /v1/webhooks/{id}/test | Send a test event to your URL. GET /v1/webhooks/{id}/deliveries shows delivery history. |
Webhook events are signed. The signing secret is shown once, when you create the subscription; use it to verify the X-HotLight-Signature header on each delivery.
| Status | Meaning |
|---|---|
400 | Bad or missing coordinates. |
401 | Missing credentials. |
403 | Your plan has no webhooks, or you reached your subscription limit. |
404 | Nothing found. |
503 | No data collected yet. Retry shortly. |
Errors are JSON with error and message.
04 Where to get it
Plans, keys and billing are handled by RapidAPI. Start on the free Basic plan.
Need higher volume, or something the API doesn't cover yet? Email [email protected].
05 Data and disclaimer
stale if it is more than five minutes old.Hot Light status comes from publicly available shop information and may be delayed, incomplete or wrong. Do not rely on it for anything where a wrong answer would matter beyond a missed doughnut. Hot Light Radar is an unofficial service and is not affiliated with, endorsed by or sponsored by any doughnut company.
Questions about the Hot Light Radar API?
Integration questions, bug reports, higher volumes or a field you need. I read every email.
[email protected]