All APIs

Live · API / 02 · Food & Location

Hot Light Radar API

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.

REFRESHED EVERY MINUTEUS-WIDENEAREST SHOPS BY LAT/LNGSIGNED WEBHOOKSFREE PLAN

01 Overview

One question,
answered fast.

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.

01

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.

02

"What's next" in one call

/v1/hotlight/next returns the nearest lit shop, or the shop whose next window starts soonest. Built for alerts.

03

Everything lit now

/v1/hotlight/active lists every shop whose light is on, nationwide or within a radius.

04

Signed webhooks

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.

05

Honest freshness

Every response carries as_of and data_age_seconds, and sets stale: true if the snapshot is more than five minutes old.

06

Free to try

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

Coordinates in,
shops out.

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
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'
JavaScript
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):

200 OK · application/json
{
  "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.
  • Data is collected every minute, so a light that just came on can take a minute or two to show up.

03 Endpoints

Read it,
or have it pushed.

Plain JSON with consistent field names. Every call to any endpoint counts as one request.

EndpointWhat it does
GET /v1/hotlightThe nearest shops with a Hot Light, nearest first, with live status. Params: lat, lng, optional count.
GET /v1/hotlight/nextThe nearest lit shop, or the shop whose next window starts soonest. Built for alerts.
GET /v1/hotlight/activeEvery 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/webhooksSubscribe 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/webhooksList your subscriptions. GET and DELETE /v1/webhooks/{id} read or remove one.
POST /v1/webhooks/{id}/testSend 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.

Errors

StatusMeaning
400Bad or missing coordinates.
401Missing credentials.
403Your plan has no webhooks, or you reached your subscription limit.
404Nothing found.
503No data collected yet. Retry shortly.

Errors are JSON with error and message.

04 Where to get it

On
RapidAPI.

Plans, keys and billing are handled by RapidAPI. Start on the free Basic plan.

05 Data and disclaimer

Where the
data comes from.

  • Source: publicly available shop information, collected once a minute and served from a cached snapshot. Coverage is US shops, about 300 of which have a Hot Light.
  • Freshness: every response says when the data was collected, and is marked stale if it is more than five minutes old.
  • Privacy: see the privacy policy for what the API logs and stores.

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?

Ask the person
who built it.

Integration questions, bug reports, higher volumes or a field you need. I read every email.

[email protected]