Get started

Sunrise and sunset in Duaer

In Duaer: Sunrise, sunset, solar noon, civil twilight, and day length for a place and up to seven consecutive days. One successful search uses 1 credit.

What you get

Duaer Sunrise and sunset calculates sun times for a place in its local time zone, one row per day.

Pick Duaer Data → Sunrise and sunset in the node creator, or open the data market. Related: US tide predictions, Weather forecast.

When to use it

Plan photography or fieldwork around daylight.
Compare day length across seasons or latitudes.

When not to use it

Weather. Use Weather forecast.
Solar energy estimates. Use Solar and climate (NASA POWER).

Search on the canvas

Open the node creator and pick Duaer Data → Sunrise and sunset.
Fill Place (such as Shanghai), or Latitude and Longitude. Optional: Date, Days.
Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

GET https://api.duaer.com/v1/data/sunrise?place=Reykjavik&date=2026-12-21
Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-sunrise
description: >-
  Duaer Sunrise and sunset. Sunrise, sunset, solar noon, civil twilight, and day length for a place and up to seven consecutive days.
  One successful search uses 1 Duaer credit.
---

# Duaer Sunrise and sunset

Duaer Sunrise and sunset calculates sun times for a place in its local time zone, one row per day.

## When to use

- Plan photography or fieldwork around daylight.
- Compare day length across seasons or latitudes.

## When not to use

- Weather. Use https://skills.duaer.com/weather.md.
- Solar energy estimates. Use https://skills.duaer.com/nasa-power.md.

## Call

`GET https://api.duaer.com/v1/data/sunrise?place=Reykjavik&date=2026-12-21`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `place`, or `latitude` and `longitude`.

- `place` — Place name, such as Seattle. Duaer looks up its coordinates.
- `latitude`, `longitude` — Optional. Coordinates instead of a place name.
- `date` — Optional. YYYY-MM-DD. Default today.
- `days` — Optional. Consecutive days, 1 to 7. Default 1.

## Examples

- `GET https://api.duaer.com/v1/data/sunrise?place=Reykjavik&date=2026-12-21` — the shortest day in Reykjavik.
- `GET https://api.duaer.com/v1/data/sunrise?place=Shanghai&days=7` — a week of sun times in Shanghai.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `place`, `latitude`, `longitude`, `timezone` — the point and its time zone.
- `date`, `sunrise`, `sunset`, `solarNoon` — ISO times with offset.
- `dayLengthSeconds`, `civilTwilightBegin`, `civilTwilightEnd` — daylight and twilight.

During polar day or night, `sunrise` and `sunset` are left out and the summary says so.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/tides.md — Duaer US tide predictions
- https://skills.duaer.com/weather.md — Duaer Weather forecast

Questions

How many credits does a Sunrise and sunset search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Which time zone does Duaer Sunrise and sunset use?

Duaer Sunrise and sunset returns times in the local time zone of the place.

In this section

Get started

US tide predictions in Duaer

In Duaer: High and low tide times and heights from NOAA for a US coastal station or the nearest station to a place. One successful search uses 1 credit.

Get started

Weather forecast in Duaer

In Duaer: Daily forecast for any city or coordinates, up to 16 days: conditions, high and low, rain amount and chance, and peak wind, from Open-Meteo. One successful search uses 1 credit.