API & Developer

Free, public JSON endpoints for time, sun, moon, and holiday data — no signup required

Getting started

Free, public, and open right now — no signup or API key required.

Base URL: https://www.zolunas.com

curl 'https://www.zolunas.com/api/time?tz=America/New_York'

No API key needed. Every endpoint below is live, CORS-enabled (callable directly from browser JS on your own site), and rate-limited to 60 requests/minute per IP on the free tier.

API Endpoints

REST routes for time, sun, moon, and holidays.

GET/api/time

Get the current time in any IANA time zone

Example request

GET /api/time?tz=America/New_York

Response

{
  "timezone": "America/New_York",
  "datetime": "2026-07-18T18:26:48.163Z",
  "localTime": "14:26:48",
  "localDate": "Jul 18, 2026",
  "dayOfWeek": "Saturday",
  "offset": "UTC-04:00",
  "offsetMinutes": -240,
  "isDST": true,
  "abbreviation": "EDT"
}
GET/api/sun

Get sunrise, sunset, solar noon, and twilight for a location

Example request

GET /api/sun?lat=40.7128&lng=-74.006&tz=America/New_York&date=2026-07-18

Response

{
  "date": "2026-07-18",
  "latitude": 40.7128,
  "longitude": -74.006,
  "timezone": "America/New_York",
  "sunrise": "05:40 AM",
  "sunset": "08:24 PM",
  "solarNoon": "01:02 PM",
  "civilDawn": "05:08 AM",
  "civilDusk": "08:56 PM",
  "dayLength": "14h 44m",
  "goldenHourMorning": ["05:40 AM", "06:20 AM"],
  "goldenHourEvening": ["07:44 PM", "08:24 PM"],
  "blueHourMorning": ["05:08 AM", "05:21 AM"],
  "blueHourEvening": ["08:44 PM", "08:56 PM"]
}
GET/api/moon

Get the moon phase for any date

Example request

GET /api/moon?date=2026-07-18

Response

{
  "date": "2026-07-18",
  "phase": "Waxing Crescent",
  "illumination": 13,
  "emoji": "🌒",
  "nextFullMoon": "2026-07-29",
  "nextNewMoon": "2026-08-13"
}
GET/api/holidays

Get public holidays and observances for a country/year

Example request

GET /api/holidays?country=US&year=2026

Response

{
  "country": "US",
  "year": 2026,
  "count": 24,
  "holidays": [
    { "date": "2026-01-01", "name": "New Year's Day", "type": "federal" },
    { "date": "2026-07-04", "name": "Independence Day", "type": "federal" }
  ]
}

Embeddable Widgets

Drop-in iframes for clocks and timers.

Stopwatch Embed

Minimal iframe stopwatch

<iframe
  src="https://www.zolunas.com/embed/stopwatch"
  width="100%" height="320"
  loading="lazy"
  title="Zolunas Stopwatch">
</iframe>

Countdown Timer Embed

Pass duration (seconds) and title

<iframe
  src="https://www.zolunas.com/embed/countdown-timer?duration=600&title=Break"
  width="100%" height="420"
  loading="lazy"
  title="Zolunas Countdown Timer">
</iframe>

Classroom Timer Embed

Projector-friendly classroom countdown

<iframe
  src="https://www.zolunas.com/embed/classroom-timer?duration=300&message=Quiet+work"
  width="100%" height="360"
  loading="lazy"
  title="Zolunas Classroom Timer">
</iframe>

Digital Clock Embed

Optional tz query param

<iframe
  src="https://www.zolunas.com/embed/digital-clock?tz=America/New_York"
  width="100%" height="280"
  loading="lazy"
  title="Zolunas Digital Clock">
</iframe>

Date Countdown Embed

Pass date (YYYY-MM-DD) and title

<iframe
  src="https://www.zolunas.com/embed/date-countdown?date=2030-01-01&title=Launch"
  width="100%" height="280"
  loading="lazy"
  title="Zolunas Date Countdown">
</iframe>

Random Wheel Embed

Comma-separated items query param

<iframe
  src="https://www.zolunas.com/embed/random-wheel?items=Red,Blue,Green,Yellow"
  width="100%" height="320"
  loading="lazy"
  title="Zolunas Random Wheel">
</iframe>

Rate Limits

One free tier today — reach out if you need more.

Free (live now)

60 req/min per IP

$0 · no key needed

Higher volume

Custom limits

Contact us

These are read-only, cached-friendly endpoints (time zone, sun, moon, and holiday data) — no account, billing, or personal data involved.