GeoAstroApi
GeoAstro API is a high‑precision astronomy REST API that delivers professional‑grade Sun, Moon and planet data for any location and date. It provides accurate rise, set and meridian transits, civil/nautical/astronomical twilight, golden hour and blue hour intervals, as well as detailed Moon phases, illumination, bright‑limb orientation and daily/monthly astro calendars. For planets, it exposes…
GeoAstroApi endpoints
| Method | Endpoint | Description |
|---|---|---|
| v1 | ||
| GET |
/v1/planet/position /v1/planet/position |
Returns the apparent azimuth and altitude of a selected planet for the given time and observer location. |
| GET |
/v1/moon/phase-angle /v1/moon/phase-angle |
Returns the geometric phase angle of the Moon for a given timestamp, plus a derived phaseId and phaseName describing the current lunar phase (new, crescent, quarter, gibbous,… |
| GET |
/v1/calendar/monthly-sun /v1/calendar/monthly-sun |
Returns, for each day of a given month and location, the main Sun transit events (sunrise, sunset, twilights and meridian transits). |
| GET |
/v1/moon/illumination /v1/moon/illumination |
Returns the illuminated fraction of the Moon for a given timestamp. |
| GET |
/v1/moon/transits /v1/moon/transits |
Returns rise, set and meridian transits for the Moon for a specific day and location. The day is identified by a start-of-day Unix timestamp (seconds). |
| GET |
/v1/planet/transits /v1/planet/transits |
Returns rise, set and meridian transits for a selected planet for a specific day and location. The day is identified by a start-of-day Unix timestamp (seconds). |
| GET |
/v1/sun/transits /v1/sun/transits |
Returns sunrise, sunset, twilights and meridian transits for the Sun for a specific day and location. The day is identified by a start-of-day Unix timestamp (seconds). |
| GET |
/v1/seasonal/seasons /v1/seasonal/seasons |
Returns timestamps for equinoxes and solstices for the given calendar year, plus a mapping by seasons for both hemispheres. |
| GET |
/v1/sun/position /v1/sun/position |
Returns the apparent azimuth and altitude of the Sun for the given time and observer location. |
| GET |
/v1/calendar/monthly-moon /v1/calendar/monthly-moon |
Returns, for each day of a given month and location, the main Moon transit events (moonrise, moonset and meridian transits), plus phase information (including illuminated… |
| GET |
/v1/moon/next-phases /v1/moon/next-phases |
Returns a list of upcoming Moon phases (new, first quarter, full, last quarter) starting from a given timestamp, searching roughly the next 30 days. |
| GET |
/v1/moon/position /v1/moon/position |
Returns the apparent azimuth and altitude of the Moon for the given time and observer location. |
| GET |
/v1/sun/summary /v1/sun/summary |
Professional-grade Sun summary for a given instant and location: current apparent position plus sunrise, sunset, twilights and meridian transits for the local day (in the… |
| GET |
/v1/moon/summary /v1/moon/summary |
Professional-grade Moon summary for a given instant and location: current position, illumination and phase plus rise/set and meridian transits for the local day (in the provided… |
| GET |
/v1/planet/list /v1/planet/list |
Returns the list of planet names supported by this API. |
| GET |
/v1/moon/bright-limb-angle /v1/moon/bright-limb-angle |
Returns the position angle of the Moon bright limb with respect to the local zenith for the given location. The angle is measured from the zenith and increases clockwise as seen… |
| GET |
/v1/moon/info /v1/moon/info |
Returns detailed illumination and phase information for the Moon: illuminated fraction, geometric phase angle and a derived phaseId/phaseName. |
| GET |
/v1/planet/visibility/daily /v1/planet/visibility/daily |
Evaluates, for a specific day and location, when a selected planet is above the horizon and when it is well observable (planet above ~15° with the Sun below -12°). |
| GET |
/v1/calendar/daily /v1/calendar/daily |
Returns, in a single payload, the main Sun and Moon events for a specific day and location: sunrise/sunset, twilights, Moon phases of the day, illumination, maximum Moon altitude… |
| GET |
/v1/calendar/golden-blue /v1/calendar/golden-blue |
Returns only the golden hour and blue hour intervals for a specific day and location, classified as morning (dawn) or evening (dusk). |
| Other endpoints | ||
| GET |
/v1/calendar/monthly-moon /v1/calendar/monthly-moon |
Returns, for each day of a given month and location, the main Moon transit events (moonrise, moonset and meridian transits), plus phase information (including illuminated… |
| GET |
/v1/moon/position /v1/moon/position |
Returns the apparent azimuth and altitude of the Moon for the given time and observer location. |
| GET |
/v1/calendar/monthly-sun /v1/calendar/monthly-sun |
Returns, for each day of a given month and location, the main Sun transit events (sunrise, sunset, twilights and meridian transits). |
| GET |
/v1/planet/visibility/daily /v1/planet/visibility/daily |
Evaluates, for a specific day and location, when a selected planet is above the horizon and when it is well observable (planet above ~15° with the Sun below -12°). |
| GET |
/v1/sun/transits /v1/sun/transits |
Returns sunrise, sunset, twilights and meridian transits for the Sun for a specific day and location. The day is identified by a start-of-day Unix timestamp (seconds). |
| GET |
/v1/sun/position /v1/sun/position |
Returns the apparent azimuth and altitude of the Sun for the given time and observer location. |
| GET |
/v1/moon/illumination /v1/moon/illumination |
Returns the illuminated fraction of the Moon for a given timestamp. |
| GET |
/v1/moon/info /v1/moon/info |
Returns detailed illumination and phase information for the Moon: illuminated fraction, geometric phase angle and a derived phaseId/phaseName. |
| GET |
/v1/seasonal/seasons /v1/seasonal/seasons |
Returns timestamps for equinoxes and solstices for the given calendar year, plus a mapping by seasons for both hemispheres. |
| GET |
/v1/moon/transits /v1/moon/transits |
Returns rise, set and meridian transits for the Moon for a specific day and location. The day is identified by a start-of-day Unix timestamp (seconds). |
| GET |
/v1/moon/bright-limb-angle /v1/moon/bright-limb-angle |
Returns the position angle of the Moon bright limb with respect to the local zenith for the given location. The angle is measured from the zenith and increases clockwise as seen… |
| GET |
/v1/planet/transits /v1/planet/transits |
Returns rise, set and meridian transits for a selected planet for a specific day and location. The day is identified by a start-of-day Unix timestamp (seconds). |
| GET |
/v1/planet/position /v1/planet/position |
Returns the apparent azimuth and altitude of a selected planet for the given time and observer location. |
| GET |
/v1/sun/summary /v1/sun/summary |
Professional-grade Sun summary for a given instant and location: current apparent position plus sunrise, sunset, twilights and meridian transits for the local day (in the… |
| GET |
/v1/planet/list /v1/planet/list |
Returns the list of planet names supported by this API. |
| GET |
/v1/moon/next-phases /v1/moon/next-phases |
Returns a list of upcoming Moon phases (new, first quarter, full, last quarter) starting from a given timestamp, searching roughly the next 30 days. |
| GET |
/v1/moon/phase-angle /v1/moon/phase-angle |
Returns the geometric phase angle of the Moon for a given timestamp, plus a derived phaseId and phaseName describing the current lunar phase (new, crescent, quarter, gibbous,… |
| GET |
/v1/moon/summary /v1/moon/summary |
Professional-grade Moon summary for a given instant and location: current position, illumination and phase plus rise/set and meridian transits for the local day (in the provided… |
| GET |
/v1/calendar/golden-blue /v1/calendar/golden-blue |
Returns only the golden hour and blue hour intervals for a specific day and location, classified as morning (dawn) or evening (dusk). |
| GET |
/v1/calendar/daily /v1/calendar/daily |
Returns, in a single payload, the main Sun and Moon events for a specific day and location: sunrise/sunset, twilights, Moon phases of the day, illumination, maximum Moon altitude… |
| GET |
/v1/moon/illumination /v1/moon/illumination |
Returns the illuminated fraction of the Moon for a given timestamp. |
| GET |
/v1/planet/visibility/daily /v1/planet/visibility/daily |
Evaluates, for a specific day and location, when a selected planet is above the horizon and when it is well observable (planet above ~15° with the Sun below -12°). |
| GET |
/v1/calendar/golden-blue /v1/calendar/golden-blue |
Returns only the golden hour and blue hour intervals for a specific day and location, classified as morning (dawn) or evening (dusk). |
| GET |
/v1/moon/bright-limb-angle /v1/moon/bright-limb-angle |
Returns the position angle of the Moon bright limb with respect to the local zenith for the given location. The angle is measured from the zenith and increases clockwise as seen… |
| GET |
/v1/seasonal/seasons /v1/seasonal/seasons |
Returns timestamps for equinoxes and solstices for the given calendar year, plus a mapping by seasons for both hemispheres. |
| GET |
/v1/calendar/daily /v1/calendar/daily |
Returns, in a single payload, the main Sun and Moon events for a specific day and location: sunrise/sunset, twilights, Moon phases of the day, illumination, maximum Moon altitude… |
| GET |
/v1/calendar/monthly-moon /v1/calendar/monthly-moon |
Returns, for each day of a given month and location, the main Moon transit events (moonrise, moonset and meridian transits), plus phase information (including illuminated… |
| GET |
/v1/moon/info /v1/moon/info |
Returns detailed illumination and phase information for the Moon: illuminated fraction, geometric phase angle and a derived phaseId/phaseName. |
| GET |
/v1/moon/phase-angle /v1/moon/phase-angle |
Returns the geometric phase angle of the Moon for a given timestamp, plus a derived phaseId and phaseName describing the current lunar phase (new, crescent, quarter, gibbous,… |
| GET |
/v1/moon/position /v1/moon/position |
Returns the apparent azimuth and altitude of the Moon for the given time and observer location. |
GeoAstroApi pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 1 / second |
|
| PRO | $19 / month | 5 / second |
|
| ULTRA Recommended | $39 / month | 20 / second |
|
| MEGA | $69 / month | 50 / second |
|