A numerology API for astrology apps

Features you can add this week

A numerology profile. Life path, destiny, soul urge and personality alongside the sun, moon and rising sign. One request per user, stored forever: the chart never changes.

A daily number next to the horoscope. POST /v1/cycles returns the personal day, month and year for the user’s local date, plus the universal number of the day. It needs only the birthdate. See personal year numbers.

Compatibility in two traditions. Show the synastry reading next to a numerology score from POST /v1/compatibility, with a rating and the pairing behind each core number. See the compatibility API.

A yearly forecast. years_ahead lists the personal year for up to 10 coming years, ready for a “your year ahead” piece in January or on the user’s birthday.

No new data to collect

Users who skip the name still get the life path and the daily numbers from their birthdate.

Your voice, our maths

The API returns numbers, not paragraphs. Your writers keep the tone and the language of your horoscopes, and the API makes sure the numbers they describe are right: master numbers kept, karmic debts flagged, and the same conventions on every call. A user who checks their life path on another site sees the same number.

Fits the way horoscope apps are built

• Cacheable: charts are deterministic, and daily numbers change once a day, so most users cost one request a day.
• Private: names and birthdates are never stored or logged by the API.
• Predictable cost: 100 requests a month free, then 10,000 for $9 or 500,000 for $49, with optional overage so a viral day does not switch features off.

Frequently asked questions

Can I add numerology to my astrology app without a numerologist?

Yes for the calculations: the API computes every number to documented conventions. You still write, or license, the text that interprets each number in your app’s voice.

Does the API return horoscope text or interpretations?

No. It returns the numbers as JSON, so the interpretations stay yours, in your tone and in every language you support.

Does numerology need the time and place of birth like astrology?

No. Numerology uses only the full name and the date of birth.

Can the API compute numerology for many users at once?

Yes. The batch endpoint computes up to 100 charts in one request, which suits adding numerology profiles to an existing user base.