Welcome to the official repository for The Numerology API—a powerful tool that combines the ancient wisdom of numerology with the celestial insights of astrology. Whether you're a developer integrating cosmic features into your applications or an enthusiast exploring the mysteries of life, this API is your key to unlocking a universe of knowledge.
“As within, so without. As in the code, so in the cosmos.” — DWS Numerology API
- 🌌 Numerological Insights: Explore personality traits, life challenges, and cycles using Pythagorean numerology methods.
- 🌠 Horoscope Revelations: Access daily, weekly, monthly, and yearly horoscopes for love, career, health, and planetary influences.
- 🌟 Zodiac Wisdom: Uncover the unique traits of each zodiac sign, from personality and love compatibility to lifestyle choices.
- API Integration: Explore the comprehensive documentation to seamlessly integrate Astro-Numerology features into your applications. You can also view and test the API on RapidAPI.
- Contribute: Join the cosmic journey! Contribute to the development, share insights, and enhance the API for the community.
- Attitude/Sun Number: Discover the essence of one's personality.
- Balance Number: Uncover the equilibrium in life.
- Challenge Number: Navigate life challenges with precision.
- Karmic Debt Number: Understand and address karmic debts.
- Karmic Lesson Numbers: Learn the lessons embedded in life experiences.
- Life Period Cycle Numbers: Gain insights into life cycles.
- Lucky Numbers: Identify numbers with positive vibes.
- Personality Number: Decode the characteristics defining an individual.
- Personal Year Number: Navigate through yearly influences.
- Rational Thought Number: Explore the intellect's influence.
- Soul Expression/Destiny Number: Reveal the soul's purpose.
- Soul Urge Number: Understand inner desires.
- Subconscious Self Number: Delve into the hidden realms of the psyche.
- Analyze a person's phone number: Uncover numeric vibrations.
- Determine Life Path: Calculate life's journey based on birthdate.
- Daily Horoscope (Yesterday, Today, Tomorrow): Receive personalized daily insights.
- Weekly Horoscope: Plan your week with astrological guidance.
- Monthly Horoscope: Navigate the month ahead with foresight.
- Yearly Personal Horoscope: Gain a holistic view of the year's events.
- Love Daily Horoscope: Explore love insights for yesterday, today, and tomorrow.
- Love Weekly Horoscope (Couples, Singles): Relationship guidance for the week.
- Love Monthly Horoscope (Couples, Singles): Love insights for the month.
- Love Yearly Couples Horoscope: Explore relationship dynamics annually.
- Love Yearly Singles Horoscope: Insights tailored for singles seeking love.
- Career Daily Horoscope: Professional insights for yesterday, today, and tomorrow.
- Career Weekly Horoscope: Plan your workweek with career-focused guidance.
- Career Monthly Horoscope: Navigate your career path for the month.
- Career Yearly Horoscope: Plan your financial and professional trajectory.
- Health Daily Horoscope: Well-being insights for yesterday, today, and tomorrow.
- Health Weekly Horoscope: Plan your week with health-focused guidance.
- Health Monthly Horoscope: Wellness insights for the month.
- Planetary Daily Horoscope: Planetary insights for yesterday, today, and tomorrow.
- Planetary Weekly/Monthly Horoscope: Explore weekly and monthly planetary influences.
- Zodiac Sign Personality: Uncover the unique traits and characteristics of each zodiac sign.
- Zodiac Sign Friendship: Explore the dynamics of friendships based on zodiac signs.
- Zodiac Sign Love: Delve into the romantic aspects of zodiac signs.
- Zodiac Sign Lifestyle: Gain a glimpse into the lifestyle preferences associated with each zodiac sign.
- Zodiac Sign Health: Understand the potential health tendencies and wellness considerations linked to specific zodiac signs.
- Zodiac Sign Spirituality: Explore the spiritual inclinations and tendencies associated with each zodiac sign.
- Zodiac Sign Career & Money: Navigate the professional and financial aspects linked to zodiac signs.
- Zodiac Sign Parent & Child: Explore the dynamics of parenting and child relationships influenced by zodiac signs.
- Zodiac Sign Birthday: Discover the unique personality traits associated with each zodiac sign based on birthdays.
- Compatibility Career: Explore astrological insights into career compatibility between individuals.
- Compatibility Friendship: Gain insights into the dynamics of friendship compatibility based on astrological signs.
- Compatibility Love: Delve into love compatibility insights, providing a deeper understanding of romantic relationships.
- Astrology Aspects: Explore the various aspects and angles between celestial bodies to understand their influence on an individual's life.
- Astrology Houses: Uncover the significance of astrological houses and their impact on different aspects of life.
- Astrology Returns: Explore significant astrological returns, such as the Solar Return and Lunar Return, to gain insights into specific periods of life.
- Astrology Terms: Familiarize yourself with essential astrology terms, creating a foundation for deeper astrological understanding.
- Planets Horoscope: Gain insights into the influence of individual planets on a person's horoscope and life path.
- Planets in Houses: Explore the significance of planets positioned in different astrological houses and their impact on an individual's life.
- Mercury Retrograde Effect: Understand the effects of Mercury retrograde on communication, technology, and daily life.
- Saturn Returns Effect: Explore the transformative effects of Saturn returns on an individual's life path and personal growth.
Gematria Calculator: Added a new endpoint /gematria that computes Gematria values using multiple systems, including:
Ordinal Gematria Reverse Ordinal Gematria Pythagorean Gematria Standard Hebrew Gematria Hidden Meaning Interpretation: Returns possible symbolic or mystical meanings for certain numerical values.
/birth-chart: Returns a full natal chart as structured JSON, including astrological positions, houses, and planetary aspects.
/birth-chart/svg: Generates and returns a high-quality SVG natal chart image.
- Supported themes:
light,dark,dark-high-contrast,classic - Supported languages:
EN,FR,PT,IT,CN,ES,RU,TR,DE,HI
Note: This endpoint returns an SVG image (Content-Type: image/svg+xml). RapidAPI’s test console may not display it correctly. Please test the endpoint using a browser, Postman, or in your frontend app. Treat the response as text, not JSON.
The /horoscope/yearly/* endpoints now includes accurate horoscope calculations for 2025.
(2026 support coming soon!)
Improvements:
API Performance Optimization: Enhanced query handling and response times for all endpoints. Better Error Handling: More detailed error messages for invalid inputs.
We're excited to announce the v0.0.5 release of the Numerology API, now enriched with mystical new endpoints that allow users to draw Tarot cards programmatically. Whether you're building a spiritual bot, daily horoscope app, or just love the magic of the cards, this update is for you!
Dive deep into your past, present, and future with a classic 3-card Tarot pull. Each card comes with its upright or reversed meaning and a corresponding image.
Optional parameter:
mode=random(default) – Shuffle fresh cards every requestmode=daily– Get a consistent reading per day
A quick yet powerful daily insight. Pull just one Tarot card to reveal guidance or affirmation for the moment.
Same mode parameter applies.
We've added 9 transformational new endpoints, expanding into affirmations, ancestral decoding, vibrational time tracking, and more — expanding the spiritual toolkit from 71 to 80 endpoints!
| Endpoint | Description |
|---|---|
/personal-day |
Returns personal day number & meaning based on DOB + date |
/personal-month |
Returns personal month number & meaning |
/lucky-days-calendar |
Generates a 9–10 week lucky day calendar |
/date-meaning |
Reduces any date (YYYY-MM-DD) into a numerological meaning |
/email-numerology |
Decodes numerology energy from an email address |
/cornerstone-letter |
Gets the first letter of a name and its cornerstone meaning |
/capstone-letter |
Gets the last letter of a first name and its capstone meaning |
/ancestor-reading |
Calculates ancestral number & spiritual legacy from family name |
/personal-day-affirmations |
Stoic-style daily affirmations based on personal day number |
Each endpoint supports GET and POST and includes robust error handling, status codes, and spiritual insights for devs, creators, and seekers.
We’ve slashed pricing and boosted request limits to support more developers, apps, and spiritual platforms.
| Plan | Old Price → New Price | Old Requests → New Requests |
|---|---|---|
| Pro | $9.99 → $9.17 |
100,000 → 130,000 req/month |
| Ultra | $69.99 → $63.17 |
350,000 → 550,000 req/month |
| Mega | $399.99 → $369.17 |
1,000,000 → 2,000,000 req/month |
👉 Free Plan still available with up to 100 requests/month.
We’re leveling up! v0.0.7 introduces 5 brand new endpoints, expanding insights into personal numerology, life cycles, and hidden patterns in names.
This release also includes our groundbreaking discovery by Etuge Anselm E. — the Hidden Passion Position Number (HPPN) & Gap Resonance, giving users a deeper understanding of how personal energy manifests.
Check out the full research here: Hidden Passion Position Number & Gap Resonance Research Paper
1️⃣ /hidden-passion
- Calculates your classic Hidden Passion Number based on the most frequent letters in your name.
- Returns number, meaning, and detailed meaning.
- Supports GET & POST requests.
- Computes your Maturity Number using your Life Path Number and Destiny Number.
- Reveals the life purpose theme you evolve into as you mature.
- Returns number, meaning, and detailed meaning.
- Supports GET & POST requests.
3️⃣ /hidden-passion-positions 💡
- Brand new discovery by Etuge Anselm E.
- Calculates Hidden Passion Position Number (HPPN) and Gap Resonance for your dominant letters.
- Shows letter positions, sum, reduced HPPN, gap vector, and meanings.
- Adds a fresh dimension to traditional Hidden Passion numerology.
- Read the Research Paper & Download Here
- Supports GET & POST requests.
- Breaks your life into 4 major long-term cycles (higher-level than Personal Year Numbers).
- Each cycle includes: start/end years, number, meaning, detailed meaning.
- Helps discover life patterns, challenges, and opportunities.
- Supports GET & POST requests.
- Maps letters in your name to 4 energy planes: Physical, Mental, Emotional, Intuitive.
- Returns counts, meaning, and detailed meaning for each plane.
- Reveals dominant energies, balance, and hidden traits.
- Supports GET & POST requests.
- All endpoints now handle GET & POST requests.
- Error handling improved across new endpoints — returns status codes with error messages.
- All endpoints return meanings and detailed meanings wherever applicable.
- Ready for integration with RapidAPI.
- Extend numerology insights beyond classic calculations.
- Discover new layers of personality and destiny with HPPN & Gap Resonance.
- Analyze long-term cycles and energy planes to optimize growth and alignment.
We step through the looking glass. v0.0.8 introduces mirror-based numerology — unlocking the hidden balance and reflective cycles between numbers. This release reveals how numbers mirror each other, form energetic loops, and guide us through transformation.
Check out the full research here: Research Paper: Mirror Numbers and Cycles Research Paper
Returns the Mirror Grid — mapping each number (1–9, 11, 22, 33) to its reflective counterpart.
- Supports both
GET&POST. - Input:
base(optional) → single number analysis, or full grid if omitted. - Input:
expanded(optional bool) → adds detailed meaning + cycles. - Output: mirror number, keyword, meaning, and (if expanded) detailed meaning, cycles, and cycle keywords.
Projects your Mirror Path & Cycles from a given birth date or base number.
- Shows how your numbers reflect into one another over time.
- Returns mirror transitions, cycle loops, and meanings.
- Useful for tracing karmic reflections and life balance themes.
- Supports both
GET&POST.
- Added expanded analysis mode with cycle tracing.
- Unified reduction logic for base numbers (respects master numbers 11, 22, 33).
- Full error handling with status codes and descriptive error messages.
- All responses return keywords, meanings, and detailed meanings where available.
- Explore the mirror dimension of numerology — see how numbers reflect hidden aspects of the self.
- Trace cycles and loops for deeper karmic insight.
- Integrate mirror grid + mirror path into spiritual apps, coaching tools, and personal dashboards.
- Unlock new guidance for balance, duality, and transformation.
- 🌐 Official Website: Visit Dakidarts
- 🐦 X (Twitter): @dakidarts - Stay updated with the latest developments and announcements.
Embrace the magic of numbers, stars, and cosmic revelations—start your journey with the Astro-Numerology API today!
🚀 Empower your applications with cosmic insights! 🚀