Sunsethue API

Example Request & Response

Query the event endpoint for a specific location, date, and event type. The response includes the quality metric and supporting fields needed to explain and act on the forecast.

https://api.sunsethue.com/event?latitude=41.4&longitude=2.2&date=2026-02-22&type=sunset

{
  "time": "2026-02-22T20:23:23.349Z",
  "location": {
    "latitude": 41.4,
    "longitude": 2.2
  },
  "grid_location": {
    "latitude": 41.5,
    "longitude": 2
  },
  "data": {
    "type": "sunset",
    "model_data": true,
    "quality": 0.45,
    "cloud_cover": 0.32,
    "quality_text": "Good",
    "time": "2026-02-22T17:32:00.000Z",
    "direction": 256.7,
    "magics": {
      "blue_hour": [
        "2026-02-22T17:55:00.000Z",
        "2026-02-22T18:07:00.000Z"
      ],
      "golden_hour": [
        "2026-02-22T17:17:00.000Z",
        "2026-02-22T17:49:00.000Z"
      ]
    }
  }
}

Coming from SunsetWX?

Since SunsetWX is not actively being maintained and has had multiple outages in the past year, many developers are looking for a reliable alternative. Sunsethue's API provides the same core data as SunsetWX but with a more accurate ray-based model, higher reliability, and regular improvements.

Important things when switching from SunsetWX to Sunsethue:

• Even though both APIs provide a score between 0% and 100%, the interpretation and distribution of the score may be different.
• Since the resolution and update times of the forecasts are different, your caching strategy may need to be adjusted.

If you need help with migrating from SunsetWX to Sunsethue, do not hesitate to contact me.

FAQ

What makes Sunsethue different from a normal sunrise/sunset API?

Sunsethue adds a forecasted quality metric so you can estimate how visually strong a sunrise or sunset is expected to be, not just when it happens. This is often very useful since not every sunrise or sunset is equal.

How accurate are the forecasts?

Due to the ray-based approach, the accuracy is higher than the conventional local grid-cell approach. Weather forecasts are always at least somewhat uncertain, so the forecasts may be wrong if the underlying weather model is wrong.

Is there a free tier for testing?

Yes, during development and testing, you do not have to pay for the credits you use. Just send me an email to have your quota increased.

How do I increase my daily quota or upgrade to pay-as-you-go?

Please contact me by mail so I can move you over to the pay-as-you-go plan, any questions are of course also welcome.

Can I cache the forecasts?

The forecasts update every 6 hours, between these updates the forecasts can be cached per location (grid cell).