# Sunrise-Sunset.org

> Sunrise and sunset times for any location in the world, plus a free public
> API. Localized sister sites each focus on the cities of their own language
> regions (they do not mirror the same set of locations): French
> (calendriersolaire.com), Spanish (salidapuestasol.com), Italian
> (alba-tramonto.org), German (sonnenzeiten.org), Portuguese
> (nascerepordosol.com), Norwegian (soltider.net) and Indonesian
> (waktumatahari.com).

## Website

- Sunrise/sunset times per city: https://sunrise-sunset.org
- Glossary of astronomical definitions: https://sunrise-sunset.org/glossary

## Free API (no key, attribution required)

Full machine-oriented reference: https://api.sunrise-sunset.org/llms.txt
OpenAPI 3.1 spec: https://api.sunrise-sunset.org/openapi.json

- v2 (recommended): GET https://api.sunrise-sunset.org/v2?lat=36.72&lng=-4.42
  Local timezone by default, ISO 8601 with offset, date ranges up to 366 days
  (date_start/date_end -- use a range instead of one request per day), golden
  and blue hour, solar position, semantic HTTP errors.
  Docs: https://sunrise-sunset.org/api
- v1 (classic, stable forever): GET https://api.sunrise-sunset.org/json
  Docs: https://sunrise-sunset.org/api/v1

Attribution: display a visible link to https://sunrise-sunset.org wherever
you show the data.