Moon Phase & Rise/Set Times by Coordinates

Get the Moon's phase name, illumination percent, age, distance, magnitude and rise/set times for any latitude/longitude and date (defaults to right now). Computed live by CycleCalcs using the open-source Astronomy Engine. No key needed, free for commercial use.

What does Moon Phase & Rise/Set Times by Coordinates do?

Moon phase, illumination, distance and rise/set times for any coordinates and date.

What can you use it for?

• Show tonight's moon phase in weather or astronomy apps.
• Plan night photography, fishing or stargazing around moonrise/moonset.
• Add lunar context to agriculture or outdoor-planning tools.
• Build a moon phase calendar for many locations at once.

Why use this Actor?

• Fast and cheap: lightweight HTTP-based Actor with no browser, so runs finish in seconds and cost very little.
• No API keys or accounts needed for the data source (see notes below).
• Clean, structured JSON that you can export as CSV, Excel, JSON or XML, or pull through the Apify API and integrations.
• Scheduling, webhooks and integrations: run it daily and send results to Google Sheets, Slack, Zapier, Make, n8n or your own API.

Input

Configure the run in the Input tab (all fields have sensible defaults).

Field	Type	Required	Default	Description
locations	array of strings	yes	-	Latitude,longitude pairs, one per line.
date	string	no	-	ISO date or datetime (UTC). Leave empty for right now.

Example input

{
  "locations": [
    "51.5074,-0.1278",
    "40.7128,-74.006"
  ]
}

Output

Results are stored in the default dataset. Download them from the Output tab or via the API.

Example result

{
  "computedAt": "2026-10-15T20:35:00.000Z",
  "phaseName": "Waxing Crescent",
  "phaseCode": "waxing_crescent",
  "illuminationPercent": 24.7,
  "ageDays": 5.2,
  "distanceKm": 405194.4,
  "magnitude": -8.65,
  "constellation": "Ophiuchus",
  "riseSetStatus": "normal",
  "riseTime": "2026-10-15T12:14:51.706Z",
  "setTime": "2026-10-15T18:55:43.254Z",
  "aboveHorizonMinutes": 400.9,
  "nextPhaseName": "First Quarter",
  "nextPhaseDate": "2026-10-18T16:12:40.565Z",
  "summary": "The Moon is a waxing crescent, 24.7 percent lit, 5.2 days into its cycle. It rises at 12:14 and sets at 18:55 UTC.",
  "attribution": "Computed by CycleCalcs (cyclecalcs.com) with the MIT-licensed Astronomy Engine. Positional astronomy only.",
  "scrapedAt": "2026-10-15T20:36:12.272Z",
  "location": "51.5074,-0.1278"
}

Output fields

Field	Type	Example
computedAt	string	"2026-10-15T20:35:00.000Z"
phaseName	string	"Waxing Crescent"
phaseCode	string	"waxing_crescent"
illuminationPercent	number	24.7
ageDays	number	5.2
distanceKm	number	405194.4
magnitude	number	-8.65
constellation	string	"Ophiuchus"
riseSetStatus	string	"normal"
riseTime	string	"2026-10-15T12:14:51.706Z"
setTime	string	"2026-10-15T18:55:43.254Z"
aboveHorizonMinutes	number	400.9
nextPhaseName	string	"First Quarter"
nextPhaseDate	string	"2026-10-18T16:12:40.565Z"
summary	string	"The Moon is a waxing crescent, 24.7 percent lit, 5.2 day...
attribution	string	"Computed by CycleCalcs (cyclecalcs.com) with the MIT-lic...
scrapedAt	string	"2026-10-15T20:36:12.272Z"
location	string	"51.5074,-0.1278"

How much does it cost?

The Actor is billed by Apify according to the pricing shown on the Pricing tab of this page. Runs are small and fast, and the Apify Free plan includes monthly platform credits so you can try it at no cost. You can set a maximum cost per run, and the Actor stops cleanly when that limit is reached.

Notes and limitations

• Coordinates as 'lat,lon'. Leave date empty for right now (UTC); give an ISO date or datetime to ask about another moment. Positions are reliable from year 1700 to 2200.
• riseTime/setTime can be empty at high latitudes during a continuous-day or continuous-night span; riseSetStatus explains why.

Tips

• Start with a small test run, then scale up the input.
• Use Schedules to automate recurring runs and Webhooks or Integrations to deliver the data where you need it.
• Call the Actor from your code with the Apify API or the official JavaScript and Python clients.

FAQ

Do I need an API key?

No. CycleCalcs's Basic tier is free with no key, up to 5,000 requests a day and 300 a minute.

Feedback

Found a bug or need an extra field? Open an issue from the Issues tab of this Actor and it will be looked at quickly.

More tools from the same author

• Solar Panel Energy Estimate by Location (PVGIS, Bulk) - Monthly solar PV energy output estimates for any location from the EU PVGIS model.
• Tide Predictions: NOAA High & Low Tide Times by Station - High and low tide times and heights for any NOAA tide station and date range.
• World Time & Timezone Converter (400+ Zones, No API) - Current time in 400+ IANA time zones, or convert a date-time between zones - local only, no external API.