AstrologyInstall

Summary

Submit birth data and a date range to check for eclipses that aspect the natal chart within that range, returning eclipse events and their astrological influences relative to the natal birth moment.

Inputs

• year (required) — Birth year in 4-digit format (e.g., 1990).
• month (required) — Birth month as number 1-12 (January=1, December=12).
• day (required) — Birth day of month (1-31).
• hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight, 12=noon).
• minute (required) — Birth minute (0-59).
• locationType (required) — Choose how to specify birth location: by city name (auto-detects coordinates) or exact latitude/longitude.
• city (required) — Birth city name (e.g., "London", "New York", "Kyiv"). Required if Location Type is City Name.
• countryCode (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR). Required if Location Type is City Name.
• latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North). Required if Location Type is Coordinates.
• longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East). Required if Location Type is Coordinates.
• startYear (required) — Start year for eclipse search.
• startMonth (required) — Start month (1-12) for eclipse search.
• startDay (required) — Start day (1-31) for eclipse search.
• endYear (required) — End year for eclipse search.
• endMonth (required) — End month (1-12) for eclipse search.
• endDay (required) — End day (1-31) for eclipse search.
• maxOrb — Maximum orb in degrees (1-10) for eclipse aspects when determining astrological influence.
• language — Language for response text and interpretations (defaults to English).
• simplify — Whether to return a simplified response with key data only; disabling returns full API response metadata.

Output shape

a single JSON object representing eclipses that form aspects to the natal chart within the specified date range, including eclipse details and their astrological meanings relative to the birth data

The response includes eclipse events with aspect details constrained by the maximum orb. If 'simplify' is enabled, only top-level key information is included; otherwise, full detailed data is returned. Errors or invalid inputs will reflect standard API error structures.

Links

• n8n community nodes installation guide