logo

Track Moon Phases with API

Whether you want to create a Lunar calendar or simply want to track upcoming Moon phases with their sign, luminosity and other details.

We have got it covered using our APIs.

orange
Moon Phases

Track Moon phases

Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s,

image

Moon calendar API

Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s,

Moon phase interpretations

Get detailed Moon phase interpretations with details for website and apps.

Create Your Own Custom APIs

Craft your own API as per your business needs. Astrology as service with custom made APIs allow your business to create multidomain APIs.

image

Get started with AstrologyAPI

Create a free account and test every endpoint with free credits. No credit card needed.

Create Your Own Custom APIs

Craft your own API as per your business needs. Astrology as service with custom made APIs allow your business to create multidomain APIs.

image

Create Your Own Custom APIs

Craft your own API as per your business needs. Astrology as service with custom made APIs allow your business to create multidomain APIs.

image

Moon phase data for apps and calendars

The Moon moves through its phases about once a month, from New Moon to Full Moon and back again. Lunar calendars, moon apps and daily horoscope screens all need this data.

Our Moon Phase API returns the phase for a given moment, what it means, and the key lunar numbers. You send a date, time and place in the same format as our other Western endpoints.

You can also get the phase a person was born under from our natal chart endpoint. That lets you mix calendar moon content and personal moon content in one product.

  • Phase name

    The phase by name, such as Full Moon or Balsamic Moon. Balsamic is the waning phase between Last Quarter and New Moon.

  • Meaning text

    A paragraph on the significance of the phase, and a report with ideas on what to do while it lasts.

  • Moon sign

    The zodiac sign the Moon is passing through at that moment.

  • Illumination and age

    How much of the Moon is lit, as a percentage. Also its age in days and the lunar day number.

  • Apogee and perigee

    Apogee is when the Moon is farthest from Earth, and perigee is when it is closest. We flag when the Moon is in either range.

  • Birth moon phase

    The phase a person was born under, with a short reading, from natal_chart_interpretation.

Moon phase endpoints, with real responses

All three are POST calls. Each takes day, month, year, hour, min, lat, lon, tzone and house_type. The samples are trimmed from our docs.

Base URL: https://json.astrologyapi.com/v1

POST/moon_phase_report

Phase and meaning

The phase for the moment you send, with its significance. The full response also has a report field with advice for the reader. It fits well on a daily moon card.

1{
2  "considered_date": "2-10-2017",
3  "moon_phase": "Balsamic Moon",
4  "significance": "The Moon now is waning and is located halfway between Last Quarter and New Moon. The seeds are moving towards maturation, while rest of the plant withers away. The energy of the plant concentrates into the seed which is preparing itself for the next cycle. In the seasonal progression, this phase represents Halloween, midway between the Fall Equinox and the Winter Solstice. The wall that separates the dead from the living, thins and ghosts walk on the plant of the living."
5}
Read the /moon_phase_report reference →
POST/lunar_metrics

Lunar numbers

Moon sign, phase, illumination, age in days and lunar day, with apogee and perigee checks. Use these values to pick icons and draw progress rings.

1{
2  "month": "10-5-1990",
3  "within_perigee_range": false,
4  "distance": "--",
5  "within_apogee_range": true,
6  "apogee_distance": 406431,
7  "moon_sign": "Scorpio",
8  "moon_phase": "Full Moon",
9  "moon_age_in_days": 15.470096481335087,
10  "moon_day": 16,
11  "moon_illumination": 99
12}
Read the /lunar_metrics reference →
POST/natal_chart_interpretation

The phase at birth

Part of the full natal chart response. The moon_phase object names the phase the person was born under and adds a reading about it.

1{
2  "moon_phase": {
3    "moon_phase_name": "First Quarter Moon",
4    "moon_phase_id": 3,
5    "moon_phase_calc": "You were born under a First Quarter Moon."
6  }
7}
Read the /natal_chart_interpretation reference →

Who builds with moon data

Over 3,000+ businesses use AstrologyAPI. These are moon features they often add.

Lunar calendar apps

Call lunar_metrics for each day of the month. Show the phase, the sign and how full the Moon is.

Western Astrology API →

Daily horoscope and wellness apps

Put a moon card next to the daily reading. Use the meaning text as a short tip for the day.

How to automate daily horoscope content →

Alert and reminder apps

Check the phase each day and send a push note when it changes, or when the Moon enters a new sign.

Building a transit alert system →

Personal astrology apps

Show each user the moon phase they were born under, right next to their birth chart.

Natal Chart API →

Moon Phase API FAQ

What does the Moon Phase API return?

It returns the phase of the Moon for a date and place, plus what that phase means. lunar_metrics adds numbers such as moon sign, illumination, age in days, and apogee and perigee checks.

What do I send in a request?

Send day, month, year, hour and min for the moment you want. Add lat, lon and tzone for the place. The format matches our natal chart calls, including house_type.

Can I build a monthly moon calendar?

Yes. Call lunar_metrics or moon_phase_report for each day you want to show. Our tropical_transits/monthly endpoint also lists the moon phases in a month, with date, sign and house for one birth chart.

Can I show the moon phase someone was born under?

Yes. natal_chart_interpretation includes a moon_phase object. It names the birth phase and adds a short reading you can show on a profile page.

Which languages does the moon text come in?

moon_phase_report and lunar_metrics are English endpoints. natal_chart_interpretation, which carries the birth moon phase, also supports Spanish, Portuguese, French, Italian, German and Russian.

How do I start?

Sign up to get an API key and 150 free credits. Then send moon_phase_report the current date and the location of your city.

Ready to add this to your app? See our plans and pricing.