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.

Returns a JSON object with full natal chart data, including planetary placements, houses, and moon phase.Request Parameters:NameTypeRequiredDescriptionnamestring YesThe name of the personyearint YesBirth year (e.g. 1990)monthint YesBirth month (112)dayint YesBirth day (131)hourint NoHour of birth (023), defaults to 12minuteint NoMinute of birth (059), defaults to 0citystring NoCity of birth (for label only)countrystring NoCountry code or namelatfloat YesLatitude of birthplace (e.g. 34.05)lngfloat YesLongitude of birthplace (e.g. -118.25)tzstring NoTimezone string (e.g. America/New_York), defaults to UTCPython Requests Example:import requestsurl = "https://the-numerology-api.p.rapidapi.com/birth-chart"querystring = {"name":"John Doe","year":"1990","month":"7","day":"16","hour":"12","minute":"0","lat":"48.8566","lng":"2.3522","city":"Paris","country":"FR","tz":"Europe/Paris"}headers = {"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"}response = requests.get(url, headers=headers, params=querystring)print(response.json())

Get the current day's horoscope based on the user's date of birth. The API calculates the zodiac sign from the provided date and delivers the corresponding astrological reading for today.Endpoint/horoscope/todayQuery ParametersNameTypeRequiredDescriptiondobstring YesThe user's date of birth in the format YYYY-MM-DD. Used to calculate the zodiac sign.Python Requests Example:import requestsurl = "https://the-numerology-api.p.rapidapi.com/horoscope/today"querystring = {"dob": "2002-02-22"}headers = {"x-rapidapi-host": "the-numerology-api.p.rapidapi.com","x-rapidapi-key": "YOUR_RAPIDAPI_KEY"}response = requests.get(url, headers=headers, params=querystring)print(response.json())

Fetch the horoscope for tomorrow based on the user's date of birth. The API determines the zodiac sign from the provided date and returns the astrological forecast for the upcoming day.Endpoint/horoscope/tomorrowQuery ParametersNameTypeRequiredDescriptiondobstring YesThe user's date of birth in the format YYYY-MM-DD. Used to calculate the zodiac sign.Python Requests Example:import requestsurl = "https://the-numerology-api.p.rapidapi.com/horoscope/tomorrow"querystring = {"dob": "2002-02-22"}headers = {"x-rapidapi-host": "the-numerology-api.p.rapidapi.com","x-rapidapi-key": "YOUR_RAPIDAPI_KEY"}response = requests.get(url, headers=headers, params=querystring)print(response.json())

Get the weekly horoscope forecast based on the user's date of birth. The API determines the zodiac sign from the provided date and returns astrological insights for the current week.Endpoint/horoscope/weeklyQuery ParametersNameTypeRequiredDescriptiondobstring YesThe user's date of birth in the format YYYY-MM-DD. Used to calculate the zodiac sign.Python Requests Example:import requestsurl = "https://the-numerology-api.p.rapidapi.com/horoscope/weekly"querystring = {"dob": "2002-02-22"}headers = {"x-rapidapi-host": "the-numerology-api.p.rapidapi.com","x-rapidapi-key": "YOUR_RAPIDAPI_KEY"}response = requests.get(url, headers=headers, params=querystring)print(response.json())

Unlock the astrological forecast for the entire month based on the user's zodiac sign. This monthly horoscope offers cosmic insights into love, career, health, and more all derived from the provided date of birth.Endpoint/horoscope/monthlyQuery ParametersNameTypeRequiredDescriptiondobstring YesThe user's date of birth in the format YYYY-MM-DD. Used to calculate the zodiac sign.Python Requests Example:import requestsurl = "https://the-numerology-api.p.rapidapi.com/horoscope/monthly"querystring = {"dob": "2002-02-22"}headers = {"x-rapidapi-host": "the-numerology-api.p.rapidapi.com","x-rapidapi-key": "YOUR_RAPIDAPI_KEY"}response = requests.get(url, headers=headers, params=querystring)print(response.json())

API

The Numerology API

Welcome to The Numerology API — a spiritual intelligence engine with 71+ powerful endpoints.
Calculate and decode numerological insights including: Life Path, Soul Urge, Destiny Number, Personality, Karmic Lessons & Debts, Challenges, Balance Number, Tarot Readings, Lucky Numbers, Attitude (Sun) Number, and more.
New features include Cornerstone & Capstone Letter analysis, Ancestral Vibration Readings, Email Numerology, Personal Day & Month calculations, Stoic Daily Affirmations, and a 9-week Lucky Days Calendar.

The API is built on the Pythagorean numerology method, supports both GET & POST requests with clean JSON responses and full error handling. The API caters to a wide range of programming languages, including but not limited to: C, Clojure, C#, GO, Java, JavaScript, Kotlin, Node.js, Objective-C, OCaml, PHP, PowerShell, Python, R, RapidQL, Ruby, Shell, and Swift.

Subscribe to the Numerology API

API Overview

The Numerology API—is a powerful tool that combines the ancient wisdom of numerology with the celestial insights of astrology. Beyond the profound insights of Pythagorean numerology, our Astro-Numerology API now seamlessly integrates horoscope and zodiac features, offering a holistic view of the mystical forces shaping individuals' lives.

“As within, so without. As in the code, so in the cosmos.”

⚡️ Key Features

🚀 Change History

v0.0.6 – Divine Expansion! (July 7, 2025)

✨ What’s New in v0.0.6

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!

🔢 New 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–12 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.

💸 Updated Pricing Plans

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.

(v0.0.5) Added Features:

/tarot/reading – Three-Card Tarot Spread

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 request
mode=daily – Get a consistent reading per day

/tarot/power – Single-Card Power Tarot

A quick yet powerful daily insight. Pull just one Tarot card to reveal guidance or affirmation for the moment.
Same mode parameter applies.

the numerology api

(v0.0.4) Added Features:

Birth Chart JSON Endpoint

/birth-chart: Returns a full natal chart as structured JSON, including astrological positions, houses, and planetary aspects.

Birth Chart SVG Endpoint

/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 numerology api

(v0.0.3) Added Features:

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

(v0.0.2) Added Features:

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.
Yearly Love Couples Horoscope: Explore relationship dynamics annually.
Yearly Love Singles Horoscope: Insights tailored for singles seeking love.
Yearly Career & Money Horoscope: Plan your financial and professional trajectory.

(v0.0.1) Features:

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.

Endpoints Overview

The Attitude/Sun Number Calculator

The Attitude/Sun Number endpoint calculates the Attitude Number, also known as the Sun Number, which represents the initial impression or appearance we portray to others when they first meet us.

Parameters

Parameter	Type	Required	Description
birth_day	int	Yes	The numeric value of the birthday (1-31)
birth_month	int	Yes	The numeric value of the birth month (1-12)

Example: GET

/attitude_number

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/attitude_number"
querystring = {"birth_day":"14","birth_month":"3"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"attitude_number": 8, 
"number_summary": "The attitude number 8 signifies ambition, success, and material abundance." 
}

The Balance Number Calculator

The Balance Number Calculator endpoint is designed to calculate the Balance Number based on the initials of a person’s name, using Pythagorean numerology. The Balance Number represents a minor influence on an individual’s life, providing insights into their abilities, talents, imperfections, and shortcomings. By understanding the Balance Number, individuals can gain wisdom and maintain balance during times of emotional upheaval.

The Balance Number is determined by adding the numerical values of the initials of a person’s full name at birth. Each letter is assigned a specific value based on the Pythagorean numerology system. The sum of these values is then reduced to a single-digit number. The API accepts name initials as parameters and returns the calculated Balance Number along with a meaningful description.

Request Parameters:

Parameter	Type	Required	Description
initials	string	Yes	The initials of the name. Example: JRD for John Robert Doe.

/balance_number

Request Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/balance_number"
querystring = {"initials":"JRD"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"balance_number": 5,
"summary": "Adaptability and freedom"
}

The Challenge Number Calculator

The Challenge Number Calculator endpoint allows you to calculate various challenge numbers based on a given birthdate. Challenge numbers play a pivotal role in shaping our lives. Derived from an individual’s birthdate, these numbers shed light on the unique obstacles and growth opportunities that await us. Each challenge number represents a specific aspect or challenge that an individual may encounter during their lifetime. By understanding and embracing these challenges, we can navigate our path with greater awareness and personal growth.

Upon making a request to the endpoint, a meticulous calculation process commences. The API analyzes the provided birthdate and computes a set of challenge numbers, each representing a unique aspect or challenge that may arise throughout an individual’s life. These challenge numbers provide profound insights into potential hurdles, enabling users to prepare, grow, and flourish in the face of adversity.

Request Parameters:

Parameter	Type	Required	Description
birth_year	int	Yes	The year of birth.
birth_month	int	Yes	The month of birth.
birth_day	int	Yes	The day of birth.

/challenge_number

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/challenge_number"
querystring = {"birth_year":"1990","birth_month":"5","birth_day":"15"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"challenge_birth": {
"Challenge_number": 1,
"Challenge_summary": "A challenge number of 1 signifies a need to learn independence. You might find yourself in a position of needing to stand up for yourself in any number of ways: your values, your faith, your own well-being, etc. Self-assertion will be a running theme during this period of your life. You will learn the advantages of individuality, develop balance, and realize your independence. Trusting will be a major challenge for you during this period, but it will be learned and tested over time, beginning with yourself."
},
"challenge_death": {
"Challenge_number": 4,
"Challenge_summary": "Your organizational skills will leave much to be desired. You may have attention deficits or simply lose interest in tasks before carrying them out to completion. You will learn the value of paying attention to detail and finishing what you start. These will be serious challenges but they will result in exponential personal growth in the long term. Efficiency in action, thought, and emotion will be achieved."
},
"challenge_life": {
"Challenge_number": 5,
"Challenge_summary": "Your lust for life will get in the way of establishing priorities. Your need to be free will lead to bondage in many facets of life if you do not make a conscious effort to prevent it. You will have to work on drawing things into your life that will have a grounding effect. Over time, you will become capable of making better decisions and carrying on long-term relationships."
},
"challenge_love": {
"Challenge_number": 4,
"Challenge_summary": "Your organizational skills will leave much to be desired. You may have attention deficits or simply lose interest in tasks before carrying them out to completion. You will learn the value of paying attention to detail and finishing what you start. These will be serious challenges but they will result in exponential personal growth in the long term. Efficiency in action, thought, and emotion will be achieved."
},
"meanings": {
"Challenge of Birth": "The Challenge of Birth represents the obstacles and lessons that you need to overcome and learn from at the beginning of your life journey. It signifies the areas where you may face resistance and difficulties but also offers opportunities for growth and personal development.",
"Challenge of Death": "The Challenge of Death symbolizes the transformative and profound lessons that you will encounter towards the end of your life journey. It represents the areas where you may experience significant transitions, endings, or transformations. This challenge invites you to embrace change, let go of attachments, and embrace new beginnings.",
"Challenge of Life": "The Challenge of Life represents the ongoing challenges and lessons that you will encounter throughout your life. It indicates the areas where you may face obstacles and have to make conscious efforts to overcome them. This challenge provides valuable experiences and opportunities for personal and spiritual growth.",
"Challenge of Love": "The Challenge of Love represents the challenges and lessons you will face in your relationships and emotional connections. It signifies the areas where you may encounter difficulties, emotional growth opportunities, and the need to cultivate understanding, compassion, and harmony in your relationships."
}
}

The Karmic Debt Number Calculator

This endpoint calculates the Karmic Debt Number based on the provided birthdate (year, month, and day). By providing the year, month, and day of birth, you can unlock profound insights into the karmic debts associated with certain numbers.

The Karmic Debt Number, derived from the Life Path Number, holds great significance as it reveals the presence of karmic debts that may have accumulated throughout one’s life journey. By understanding and acknowledging these debts, individuals can gain valuable self-awareness and work towards resolving them.

Imagine the profound impact this knowledge can have on personal growth and spiritual development. This endpoint serves as a guide, illuminating the hidden connections between numbers and the karmic patterns that shape our lives. With this newfound understanding, you can embark on a transformative journey towards balance and harmony.

Request Parameters:

Parameter	Type	Required	Description
year	int	Yes	The year of birth.
month	int	Yes	The month of birth.
day	int	Yes	The day of birth.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/karmic_debt"
querystring = {"year":"2023","month":"6","day":"28"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"karmic_number": 14, 
"life_path_number": 5, 
"summary": "The karmic number 14 represents a karmic debt related to self-discipline and temperance. Individuals with this karmic debt number may struggle with maintaining balance in their lives and making wise choices." 
}

The Karmic Lessons Number Calculator

In our journey through life, there are hidden forces and energies that shape our experiences and influence our personal growth. Have you ever wondered about the profound impact your name can have on your spiritual development? Enter the world of the Karmic Lessons Number Calculator, a powerful endpoint that unveils the secrets held within your full name and provides invaluable insights into areas of personal growth and development.

The concept of karmic lessons stems from the idea that each individual possesses a unique spiritual path, filled with opportunities for growth and learning. Karmic lessons are represented by the missing numbers in one’s full name. These missing numbers, also known as karmic numbers, hold significant meaning and indicate areas in which an individual may face challenges and need to develop further.

Upon making a request, the endpoint meticulously analyzes the provided name and identifies the missing numbers, which are synonymous with karmic lessons. These lessons represent specific areas of personal growth and development that require attention and nurturing. The API then generates a comprehensive list of these karmic lessons, accompanied by detailed summaries that shed light on their significance. Prepare to embark on a transformative journey as we delve into the depths of this extraordinary API.

Request Parameters:

Parameter	Type	Required	Description
full_name	string	Yes	The full name to analyze for karmic lessons. This parameter should be provided in the query string.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/karmic_lessons"
querystring = {"full_name":"John Doe Smith"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"karmic_lessons": [3, 7], 
"karmic_lessons_summary": [ 
"The karmic lesson associated with the number 3 is self-expression and creativity. Cultivate your artistic abilities and find joy in self-expression.", 
"The karmic lesson associated with the number 7 is introspection and spirituality. Cultivate your spiritual side and deepen your understanding of yourself." 
] 
}

The Life Path Number Calculator

Life is a magnificent journey filled with twists and turns, challenges and triumphs. Have you ever wondered about the deeper meaning behind your life experiences and the path you are destined to follow? Prepare to embark on a transformative exploration as we delve into the Life Path Number Calculator endpoint. This endpoint harnesses the wisdom of numerology to unveil the secrets hidden within your dates of birth – the year, month, and day., providing profound insights into your life path and guiding you towards personal fulfillment.

At the core of numerology lies the remarkable concept of the life path number. This unique numerical value, derived from an individual’s dates of birth, acts as a guiding beacon that unveils the essence of their life’s purpose, traits, challenges, and potentials. By understanding the life path number, we gain profound insights into our inherent gifts, the lessons we are meant to learn, and the path we are destined to follow.

Request Parameters:

Parameter	Type	Required	Description
year	int	Yes	The year of birth.
month	int	Yes	The month of birth.
day	int	Yes	The day of birth.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/life_path"
querystring = {"year":"1990","month":"5","day":"12"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"life_path_number": 3, 
"summary": "The life path number 3 embodies creativity, self-expression, and social interaction. People with this life path are often joyful, optimistic, and skilled in communication."
}

The Lucky Numbers Calculator

Have you ever wondered if there is a hidden code that holds the key to unlocking fortune in your life? Throughout history, people have believed in the power of numbers to influence their fate. Lucky numbers are those imbued with positive energy, believed to bring good fortune and opportunities. Pythagorean numerology, an ancient practice, assigns numerical values to letters and combines them with birthdate data to unveil a set of lucky numbers tailored to an individual’s unique vibration.

Imagine the power of aligning yourself with the forces of luck and opportunity. With this endpoint, you can embark on a transformative journey of self-discovery and fortune. By uncovering your personalized set of lucky numbers, you gain a powerful tool for enhancing your chances of success. These auspicious numbers can guide you towards the path of prosperity and making informed choices.

Request Parameters:

Parameter	Type	Required	Description
birthdate	string	Yes	The birthdate of the person in the format ‘YYYY-MM-DD’.
name	string	Yes	The full birth name of the person.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/lucky_numbers"
querystring = {"birthdate":"1990-05-15","full_name":"John Robert Doe"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"lucky_numbers": { 
"destiny_number": 5, 
"inner_dream_number": 4, 
"life_path_number": 3, 
"lucky_number": 3, 
"soul_number": 6, 
"soul_urge_number": 1 
} 
}

The Life Period Cycle Numbers Calculator

Imagine the power of unlocking the secret code that governs the chapters of your life, allowing you to align your actions and intentions with the prevailing energies of each period. With the Life Period Cycle Numbers endpoint, you can embark on a transformative journey of self-discovery and personal growth. By gaining a deep understanding of your period cycle numbers, you unlock the door to self-awareness, purpose, and direction. Armed with this knowledge, you can make conscious choices, embrace the lessons each period brings, and navigate your life’s journey with intention and grace.

Once a request is made to the endpoint, a meticulous process unfolds. The API carefully analyzes the provided date of birth, unravelling the intricate numerical patterns that define each life period cycle. It calculates the cycle numbers associated with specific time frames, each with its own distinct energy and focus. With the period cycle numbers in hand, individuals can explore the profound descriptions accompanying each cycle, gaining clarity and guidance on how to navigate the corresponding phase of their lives.

Request Parameters:

Parameter	Type	Required	Description
birth_year	int	Yes	The four-digit year of birth.
birth_month	int	Yes	The month of birth (1-12).
birth_day	int	Yes	The day of birth (1-31).

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/period_cycles"
querystring = {"birth_month":"5","birth_day":"15","birth_year":"1990"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"life_path": { 
"life_path_number": 3 
}, 
"periods": { 
"first_period": { 
"cycle": "0 - 33 yrs", 
"number": 5, 
"number_meaning": "The fifth period number signifies a time of change and freedom. It is a phase where adaptability, adventure, and embracing new experiences lead to personal and professional growth." 
}, 
"second_period": { 
"cycle": "34 - 60 yrs", 
"number": 6, 
"number_meaning": "The sixth period number signifies a time of responsibility and harmony. It is a phase where nurturing, family, relationships, and service to others take center stage." 
}, 
"third_period": { 
"cycle": "61 yrs", 
"number": 1, 
"number_meaning": "The first period number signifies a time of self-discovery and new beginnings. It is a phase of learning about oneself and the world, and facing the realities of life." 
} 
}
}

The Personality Numbers Calculator

Every person possesses a unique essence that sets them apart from others—a captivating blend of qualities, traits, and characteristics that define who they truly are. Have you ever wondered if there is a numerical code that can unveil the depths of your personality?

At the heart of this endpoint lies the captivating concept of the Personality Number. Derived from the consonants in your full name at birth, the Personality Number serves as a unique numerical fingerprint that reflects specific personality traits and characteristics. By delving into the depths of this number, we gain valuable insights into the essence of who we truly are, empowering us to embrace our strengths, understand our tendencies, and nurture personal growth.

Request Parameters:

Parameter	Type	Required	Description
first_name	string	Yes	The first name of the person.
middle_name	string	Yes	The middle name of the person.
last_name	string	Yes	The last name of the person.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/personality_number"
querystring = {"first_name":"John","middle_name":"Robert","last_name":"Doe"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"personality_number": 4, 
"summary": "The Personality Number 4 represents practicality, discipline, and hard work. Individuals with this number are reliable, organized, and excel in structured environments." 
}

The Personal Year Numbers Calculator

Imagine if you had a road map that could guide you through the twists and turns of life, offering insights into the energies and experiences that each passing year holds. Introducing the Personal Year Number Calculator endpoint—a revolutionary tool designed to empower individuals by unlocking the secrets of their personal year number. By inputting your date of birth and the prediction year, this extraordinary endpoint harnesses the power of numerology to provide profound insights into the energies and influences that may shape your journey during a specific year.

At the heart of this API, also lies the concept of the personal year number—a numeric code that captures the unique energies and experiences that await you in a given year. By understanding your personal year number, you gain a profound awareness of the prevailing dynamics that may impact your life during that time. This knowledge serves as a guiding light, helping you navigate challenges, seize opportunities, and make informed decisions that align with the energies of each year.

Request Parameters:

Parameter	Type	Required	Description
prediction_year	int	Yes	The year for which the personal year number is calculated.
birth_month	int	Yes	The month of birth.
birth_day	int	Yes	The day of birth.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/personal_year"
querystring = {"prediction_year":"2023","birth_month":"12","birth_day":"3"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"personal_year_number": 4, 
"summary": "The personal year number 4 represents stability, hard work, and practicality. It is a year to establish solid foundations, set clear goals, and diligently work towards achieving them."
}

The Phone Number Analyzer

Have you ever wondered if there’s more to your phone number than just a series of digits? Delve into the mystical realm of numerology with the Phone Number Analyzer endpoint—a cutting-edge tool that unravels the hidden energies and vibrations encoded within your phone number. By leveraging the principles of numerology, this powerful endpoint calculates the vibration energy of your phone number and unveils insightful information about its overall essence and the significance of its minor numbers.

Your phone number is more than just a string of digits—it carries a vibrational resonance that can influence your interactions, connections, and opportunities. By utilizing the Phone Number Analyzer endpoint, you can tap into this powerful energy, aligning it with your goals and aspirations. This endpoint uncovers the significance of the minor numbers that make up your phone number. Each minor number carries its own unique energetic qualities, contributing to the overall vibration and symbolism of your phone number. By exploring these minor numbers, you gain a deeper appreciation for the hidden nuances and potentials that lie within your phone number.

Request Parameters:

Parameter	Type	Required	Description
phone_number	int	Yes	The phone number to analyze. Assume the phone number is +1(206) 685 2344, the endpoint will expect: 12066852344

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/analyze_phone"
querystring = {"phone_number":"12066852344"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"overall_minor_numbers": [ 
{ 
"description": "[ Reserved - Practical - Grounded ]", 
"number": 4, 
"occurrence": 2, 
"percentage": 18.2 
}, 
{ 
"description": "[ Harmonious - Compassionate - Tolerant ]", 
"number": 6, 
"occurrence": 2, 
"percentage": 18.2 
}, 
{ 
"description": "[ Neutral 'Buffer' Number - No Attributes ]", 
"number": 0, 
"occurrence": 1, 
"percentage": 9.1 
}, 
{ 
"description": "[ Sensitive - Intuitive - Flexible ]", 
"number": 2, 
"occurrence": 2, 
"percentage": 18.2 
}, 
{ 
"description": "[ Strong - Independent - Confident ]", 
"number": 1, 
"occurrence": 1, 
"percentage": 9.1 
}, 
{ 
"description": "[ Dynamic - Energetic - Adaptable ]", 
"number": 5, 
"occurrence": 1, 
"percentage": 9.1 
}, 
{ 
"description": "[ Creative - Inspiring - Optimistic ]", 
"number": 3, 
"occurrence": 1, 
"percentage": 9.1 
}, 
{ 
"description": "[ Ambitious - Successful - Materialistic ]", 
"number": 8, 
"occurrence": 1, 
"percentage": 9.1 
} 
], 
"phone_number": "12066852344", 
"phone_overall_vibration": 5, 
"phone_vibration_description": "[ Dynamic - Energetic - Adaptable ]" 
}

The Soul Expression/Destiny Number Calculator

The Expression/Destiny Number Calculator endpoint offers an intuitive and enlightening experience for individuals seeking to uncover the blueprint of their lives. By inputting your first name, middle name, and last name, this endpoint initiates a precise calculation process that reveals your Destiny Number and provides comprehensive information about its significance and implications.

Imagine the advantage of gaining a deeper understanding of your life’s purpose and potential. The Expression/Destiny Number Calculator endpoint allows you to tap into this profound wisdom, offering clarity and guidance as you navigate the various facets of your existence. By embracing your Destiny Number, you can align your actions, make informed decisions, and live a life that resonates with your authentic self.

Request Parameters:

Parameter	Type	Required	Description
first_name	string	Yes	The first name of the person.
middle_name	string	Optional	The middle name of the person.
last_name	string	Yes	The last name of the person.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/destiny_number"
querystring = {"first_name":"John","middle_name":"Doe","last_name":"Smith"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"destiny_number": 5, 
"summary": "The destiny number 5 represents freedom, versatility, and adventure."
}

The Heart's Desire/Soul Urge Number Calculator

Our names are more than mere letters—they carry vibrational resonance that shapes our life’s trajectory. The Expression/Destiny Number Calculator endpoint decodes the intricate symbolism and energies intertwined within your name, allowing you to delve into the depths of its meaning. By embracing this profound understanding of your Destiny Number, you gain the ability to navigate life’s choices, make conscious decisions, and align your actions with your true essence.

The Expression/Destiny Number Calculator endpoint empowers you to explore the depths of your soul’s purpose. By simply providing your first name, middle name, and last name, this powerful endpoint initiates a precise calculation process, unravelling the hidden code within your name to reveal your Destiny Number. Moreover, it provides comprehensive information about the profound significance and influences of your Destiny Number, guiding you towards a life of authenticity and fulfillment.

Request Parameters:

Parameter	Type	Required	Description
first_name	string	Yes	The first name of the person.
middle_name	string	Yes	The middle name of the person.
last_name	string	Yes	The last name of the person.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/heart_desire"
querystring = {"first_name":"John","middle_name":"Robert","last_name":"Doe"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"heart_desire_number": 5, 
"summary": "The Heart's Desire Number 5 represents freedom, adventure, and versatility. People with this number are drawn to exciting experiences, change, and exploration."
}

The Subconscious Self Number Calculator

At the heart of the Subconscious Self Number lies the profound concept of the subconscious mind—an intricate tapestry that influences our thoughts, behaviours, and responses to various situations. By understanding the Subconscious Self Number, we gain valuable insights into our inherent capabilities and tendencies, enabling us to navigate life’s challenges with a deeper understanding of ourselves.

The Subconscious Self Number Calculator endpoint serves as a gateway to discovering your hidden potential and understanding your subconscious patterns. By harnessing the insights provided by this powerful endpoint, you gain a clearer understanding of your unique capabilities and how they influence your responses to different situations. Armed with this knowledge, you can tap into your innate strengths, make informed decisions, and embrace personal growth on a profound level.

Request Parameters:

Parameter	Type	Required	Description
name	string	Yes	The full birth name of the person.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/subconscious_number"
querystring = {"name":"John Robert Doe"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"meaning": "Introspection and spirituality", 
"subconscious_self_number": 7
}

The Rational Thought Number Calculator

The Rational Thought Number endpoint—a transformative tool rooted in the profound wisdom of Pythagorean numerology. By unlocking the secrets encoded within your name, this powerful endpoint calculates your Rational Thought Number, offering profound insights into your thought patterns, decision-making processes, and problem-solving approach. By uncovering your Rational Thought Number, you gain a deeper understanding of your unique cognitive framework and unlock the power to make more rational and informed choices.

Request Parameters:

Parameter	Type	Required	Description
first_name	string	Yes	The first birth name of the person. Assume the full birth names are John Robert Doe, the endpoint expects: John.
birth_day	int	Yes	The day of the month the person was born. (1-31)

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/thought_number"
querystring = {"first_name":"John","birth_day":"15"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{ 
"meaning": "Practical and dreamy thinker, combines logic with visualization", 
"rational_thought_number": 8
}

Gematria Calculator

The Gematria Calculator API allows users to compute the Gematria value of a given text using different Gematria systems, including Ordinal, Reverse Ordinal, Pythagorean, and Standard Hebrew Gematria. Additionally, the API provides hidden meaning interpretations for certain numerical values.

Request Parameters:

Parameter	Type	Required	Description
text	string	Yes	The day of the month the person was born. (1-31)

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/gematria"
querystring = {"text":"Hello there"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"ordinal_gematria": 108,
"ordinal_hidden_meaning": "No specific hidden meaning found",
"pythagorean_gematria": 54,
"reverse_ordinal_gematria": 162,
"standard_hebrew_gematria": 0,
"text": "Hello there"
}

Birth Chart Report

Returns a JSON object with full natal chart data, including planetary placements, houses, and moon phase.

Request Parameters:

Name	Type	Required	Description
`name`	string	✅ Yes	The name of the person
`year`	int	✅ Yes	Birth year (e.g. `1990`)
`month`	int	✅ Yes	Birth month (1–12)
`day`	int	✅ Yes	Birth day (1–31)
`hour`	int	❌ No	Hour of birth (0–23), defaults to `12`
`minute`	int	❌ No	Minute of birth (0–59), defaults to `0`
`city`	string	❌ No	City of birth (for label only)
`country`	string	❌ No	Country code or name
`lat`	float	✅ Yes	Latitude of birthplace (e.g. `34.05`)
`lng`	float	✅ Yes	Longitude of birthplace (e.g. `-118.25`)
`tz`	string	❌ No	Timezone string (e.g. `America/New_York`), defaults to `UTC`

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/birth-chart"
querystring = {"name":"John Doe","year":"1990","month":"7","day":"16","hour":"12","minute":"0","lat":"48.8566","lng":"2.3522","city":"Paris","country":"FR","tz":"Europe/Paris"}
headers = {"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Birth Chart Report (SVG)

Returns the SVG chart of the person's natal chart. This is a visual representation that includes planetary symbols, houses, aspects, and more.

Request Parameters:

Name	Type	Required	Description
`name`	string	✅ Yes	The name of the person
`year`	int	✅ Yes	Birth year (e.g. `1990`)
`month`	int	✅ Yes	Birth month (1–12)
`day`	int	✅ Yes	Birth day (1–31)
`hour`	int	❌ No	Hour of birth (0–23), defaults to `12`
`minute`	int	❌ No	Minute of birth (0–59), defaults to `0`
`city`	string	❌ No	City of birth (for label only)
`country`	string	❌ No	Country code or name
`lat`	float	✅ Yes	Latitude of birthplace (e.g. `34.05`)
`lng`	float	✅ Yes	Longitude of birthplace (e.g. `-118.25`)
`tz`	string	❌ No	Timezone string (e.g. `America/New_York`), defaults to `UTC`

Additional Parameters

Name	Type	Required	Description
`lang`	string	❌ No	Language for chart labels. Default: `EN`
`theme`	string	❌ No	Chart theme style. Default: `classic`

Supported Languages:

EN, FR, PT, IT, CN, ES, RU, TR, DE, HI

Supported Themes:

classic, light, dark, dark-high-contrast

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/birth-chart/svg"
querystring = {"name":"John Doe","year":"1990","month":"7","day":"16","hour":"12","minute":"0","lat":"48.8566","lng":"2.3522","city":"Paris","country":"FR","tz":"Europe/Paris","lang":"EN","theme":"dark"}
headers = {"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Power Tarot (Single-Card)

This Power Tarot endpoint delivers a focused, single-card tarot reading designed to give you clarity, empowerment, and inspiration for the day. Great for quick insights or setting your daily intention. Choose between random inspiration or a daily consistent draw based on your birth date.

Request Parameters:

Name	Type	Required	Description
name	string	Yes	Name of the user (used for deterministic readings)
dob	string	Yes	Date of birth in `YYYY-MM-DD` format
mode	string	No	`random` (default) or `daily` for consistent daily readings

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/tarot/power"
querystring = {"name":"Alice","dob":"1988-07-20","mode":"random"}
headers = {"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Three-Card Tarot Reading

Discover the story of your past, present, and future in just one reading.
This endpoint delivers a classic three-card tarot spread, providing spiritual insights and guidance tailored to your name and date of birth.

Request Parameters:

Name	Type	Required	Description
name	string	Yes	Name of the user (used for deterministic readings)
dob	string	Yes	Date of birth in `YYYY-MM-DD` format
mode	string	No	`random` (default) or `daily` for consistent daily readings

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/tarot/reading"
querystring = {"name":"Alice","dob":"1988-07-20","mode":"random"}
headers = {"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Yesterday's Horoscope

Retrieve the horoscope for yesterday based on the user's date of birth. The system automatically determines the zodiac sign from the provided date and returns the corresponding astrological forecast.

Endpoint

/horoscope/yesterday

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in the format `YYYY-MM-DD`. Used to calculate the zodiac sign.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/yesterday"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Today's Horoscope

Get the current day's horoscope based on the user's date of birth. The API calculates the zodiac sign from the provided date and delivers the corresponding astrological reading for today.

Endpoint

/horoscope/today

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in the format `YYYY-MM-DD`. Used to calculate the zodiac sign.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/today"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Tomorrow's Horoscope

Fetch the horoscope for tomorrow based on the user's date of birth. The API determines the zodiac sign from the provided date and returns the astrological forecast for the upcoming day.

Endpoint

/horoscope/tomorrow

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in the format `YYYY-MM-DD`. Used to calculate the zodiac sign.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/tomorrow"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Weekly Horoscope

Get the weekly horoscope forecast based on the user's date of birth. The API determines the zodiac sign from the provided date and returns astrological insights for the current week.

Endpoint

/horoscope/weekly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in the format `YYYY-MM-DD`. Used to calculate the zodiac sign.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/weekly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

What to Watch – Weekly Horoscope

Discover what to watch this week based on your zodiac sign! This fun horoscope twist offers personalized entertainment recommendations aligned with your astrological forecast. Just provide a date of birth and let the stars guide your screen time.

Endpoint

/horoscope/weekly/watch

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in the format `YYYY-MM-DD`. Used to calculate the zodiac sign.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/weekly/watch"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Weekly Money Horoscope

Gain insights into your financial energy for the week based on your zodiac sign. This horoscope delivers guidance on money matters, spending habits, and financial opportunities — all tailored from your date of birth.

Endpoint

/horoscope/weekly/money

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in the format `YYYY-MM-DD`. Used to calculate the zodiac sign.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/weekly/money"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Weekly Retail Horoscope

Wondering if it's the right week to shop, splurge, or save? The Weekly Retail Horoscope provides zodiac-based insights into your shopping energy and retail tendencies — from impulse buys to bargain blessings.

Endpoint

/horoscope/weekly/retail

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in the format `YYYY-MM-DD`. Used to calculate the zodiac sign.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/weekly/retail"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Monthly Horoscope

Unlock the astrological forecast for the entire month based on the user's zodiac sign. This monthly horoscope offers cosmic insights into love, career, health, and more — all derived from the provided date of birth.

Endpoint

/horoscope/monthly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in the format `YYYY-MM-DD`. Used to calculate the zodiac sign.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/monthly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Yearly Personal Horoscope

Get a personalized horoscope for a specific year, tailored to your zodiac sign. This endpoint provides a comprehensive forecast based on your date of birth — covering themes like growth, challenges, relationships, and more throughout the chosen year.

Endpoint

/horoscope/yearly/personal

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign.
`year`	number	✅ Yes	The target year for the horoscope forecast (e.g., 2024). Supported range: 2023–2025. Default: `2025`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/yearly/personal"
querystring = {"dob": "2002-02-22", "year": "2025"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Yearly Love Couples Horoscope

Explore what the stars have in store for your romantic relationship throughout the year. This horoscope is crafted using one partner’s date of birth to deliver love insights, relationship forecasts, and emotional trends for the specified year.

Endpoint

/horoscope/yearly/love_couples

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign.
`year`	number	✅ Yes	The target year for the horoscope forecast (e.g., 2024). Supported range: 2023–2025. Default: `2025`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/yearly/love_couples"
querystring = {"dob": "2002-02-22", "year": "2025"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Yearly Love Singles Horoscope

Curious about your romantic outlook for the year ahead? This horoscope is tailored for singles, providing personalized love guidance, emotional energy trends, and potential romantic developments — all based on your zodiac sign.

Endpoint

/horoscope/yearly/love_singles

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign.
`year`	number	✅ Yes	The target year for the horoscope forecast (e.g., 2024). Supported range: 2023–2025. Default: `2025`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/yearly/love_singles"
querystring = {"dob": "2002-02-22", "year": "2025"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Yearly Career & Money Horoscope

Get powerful insights into your career path and financial outlook for the year. This zodiac-based forecast highlights professional opportunities, money trends, and decision-making guidance based on your astrological profile.

Endpoint

/horoscope/yearly/career_money

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign.
`year`	number	✅ Yes	The target year for the horoscope forecast (e.g., 2024). Supported range: 2023–2025. Default: `2025`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/yearly/career_money"
querystring = {"dob": "2002-02-22", "year": "2025"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Yesterday's Love Horoscope

Look back on yesterday’s love forecast to gain emotional insight and context around romantic energy, connections, or missed vibes. Based on your zodiac sign derived from your date of birth.

Endpoint

/horoscope/love/yesterday

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/love/yesterday"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Today’s Love Horoscope

Tap into the romantic energy of the day with this love-focused horoscope. Based on your zodiac sign, this forecast helps you navigate relationships, emotional connections, and romantic vibes for today.

Endpoint

/horoscope/love/today

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/love/today"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Tomorrow's Love Horoscope

Curious about your romantic vibes for tomorrow? This love horoscope forecasts the emotional energy and relationship opportunities coming your way, based on your zodiac sign derived from your birthdate.

Endpoint

/horoscope/love/tomorrow

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/love/tomorrow"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Love Couples – Weekly Horoscope

Explore the weekly relationship dynamics with this love horoscope designed for couples. Based on your zodiac sign, it offers insights into connection strength, communication energy, and emotional compatibility for the week ahead.

Endpoint

/horoscope/love_couples/weekly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/love_couples/weekly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Love Singles – Weekly Horoscope

Get a weekly love forecast for singles, based on your zodiac sign. This horoscope highlights emotional trends, potential romantic opportunities, and self-love advice tailored to your astrological energy.

Endpoint

/horoscope/love_singles/weekly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/love_singles/weekly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Love Couples – Monthly Horoscope

Navigate your relationship with clarity using this monthly love horoscope for couples. Based on your zodiac sign, it offers emotional insights, intimacy guidance, and communication patterns for you and your partner over the course of the month.

Endpoint

/horoscope/love_couples/monthly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/love_couples/monthly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Love Singles – Monthly Horoscope

Step into the month with clarity and confidence in your love life. This monthly horoscope for singles reveals your romantic energy, emotional trends, and potential connections — all based on your zodiac sign.

Endpoint

/horoscope/love_singles/monthly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/love_singles/monthly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Yesterday's Career Horoscope

Reflect on the career energy and professional influences from yesterday. This horoscope provides insight into productivity, decision-making, communication, and work-related themes based on your zodiac sign.

Endpoint

/horoscope/career/yesterday

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/career/yesterday"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Today's Career Horoscope

Unlock your professional potential with insights from today’s career horoscope. Based on your zodiac sign, this forecast reveals productivity boosts, work dynamics, communication strengths, and areas of focus for the day.

Endpoint

/horoscope/career/today

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/career/today"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Tomorrow's Career Horoscope

Plan ahead with this career horoscope for tomorrow, offering guidance on upcoming work opportunities, challenges, and focus areas. Your zodiac sign helps map out the professional energy for the day ahead.

Endpoint

/horoscope/career/tomorrow

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/career/tomorrow"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Weekly Career Horoscope

Navigate your professional path with this weekly career horoscope. Based on your zodiac sign, it offers guidance on job performance, workplace dynamics, ambition levels, and success opportunities for the week ahead.

Endpoint

/horoscope/career/weekly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/career/weekly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Monthly Career Horoscope

Get a broader view of your career landscape for the month. This zodiac-based forecast reveals professional growth opportunities, work challenges, energy shifts, and motivation cycles to help you stay aligned with your goals.

Endpoint

/horoscope/career/monthly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/career/monthly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Yesterday's Health Horoscope

Review your physical and emotional well-being energy from yesterday. This health horoscope reflects the planetary influences on vitality, stress levels, rest cycles, and overall wellness based on your zodiac sign.

Endpoint

/horoscope/health/yesterday

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/health/yesterday"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Today's Health Horoscope

Stay aligned with your mind-body balance using today’s health horoscope. This forecast provides zodiac-based insight into your physical wellness, mental clarity, and energetic flow for the current day.

Endpoint

/horoscope/health/today

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/health/today"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Tomorrow's Health Horoscope

Prepare for tomorrow’s energy with this health-focused horoscope. Based on your zodiac sign, it offers guidance on physical stamina, emotional well-being, and potential health patterns for the day ahead.

Endpoint

/horoscope/health/tomorrow

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/health/tomorrow"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Weekly Health Horoscope

Gain a broader perspective on your well-being for the week ahead. This health horoscope delivers zodiac-based insights into energy levels, emotional balance, recovery trends, and overall wellness themes.

Endpoint

/horoscope/health/weekly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/health/weekly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Monthly Health Horoscope

Stay in tune with your physical and emotional rhythms for the month. This horoscope delivers zodiac-based guidance on wellness patterns, self-care timing, mental clarity, and energy fluctuations over the next 30 days.

Endpoint

/horoscope/health/monthly

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The user's date of birth in `YYYY-MM-DD` format. Used to determine the zodiac sign for the love horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/health/monthly"
querystring = {"dob": "2002-02-22"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Daily Planetary Horoscope

Discover how the planetary positions are influencing your life today. This daily horoscope highlights celestial alignments and their effects on your emotions, decisions, energy, and spiritual alignment — tailored to your zodiac sign.

Endpoint

/horoscope/planetary/daily

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Determines your zodiac sign and planetary alignment.
`day`	string	✅ Yes	The day to fetch the planetary horoscope for. Accepted values: `yesterday`, `today`, `tomorrow`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/planetary/daily"
querystring = {"dob": "1990-01-01", "day": "today"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Weekly / Monthly Planetary Horoscope

Access an astrological overview of planetary influences over a longer cycle — weekly or monthly. This forecast highlights how planetary movements align with your zodiac sign, revealing themes of transformation, pressure, ease, and cosmic support.

Endpoint

/horoscope/planetary/overview

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Determines your zodiac sign and planetary alignment.
`period`	string	✅ Yes	The desired period for the horoscope. Accepted values: `weekly`, `monthly`. Default: `weekly`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/planetary/overview"
querystring = {"dob": "1990-01-27", "period": "weekly"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Sign Personality Horoscope

Discover the core traits, strengths, and tendencies of your zodiac sign with this personality-focused horoscope. Based on your date of birth, it provides insights into your character, motivations, and unique astrological profile.

Endpoint

/horoscope/sign/personality

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Used to determine your zodiac sign and generate the personality horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/sign/personality"
querystring = {"dob": "1990-05-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Sign Friendship Horoscope

Explore how your zodiac sign influences your friendships and social connections. This horoscope reveals your natural tendencies in friendships, compatibility with others, and tips to nurture meaningful relationships.

Endpoint

/horoscope/sign/friendship

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Used to determine your zodiac sign and generate the personality horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/sign/friendship"
querystring = {"dob": "1990-05-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Sign Love Horoscope

Discover your romantic nature and love tendencies based on your zodiac sign. This horoscope offers insights into your relationship style, emotional needs, and compatibility with potential partners.

Endpoint

/horoscope/sign/love

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Used to determine your zodiac sign and generate the personality horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/sign/love"
querystring = {"dob": "1990-05-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Sign Lifestyle Horoscope

Uncover how your zodiac sign influences your habits, routines, and overall lifestyle. This horoscope highlights your natural preferences in health, leisure, work-life balance, and personal development.

Endpoint

/horoscope/sign/lifestyle

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Used to determine your zodiac sign and generate the personality horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/sign/lifestyle"
querystring = {"dob": "1990-05-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Sign Health Horoscope

Understand your zodiac sign’s influence on your physical and emotional well-being. This horoscope explores health patterns, stress triggers, energy cycles, and self-care tendencies linked to your astrological profile.

Endpoint

/horoscope/sign/health

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Used to determine your zodiac sign and generate the personality horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/sign/health"
querystring = {"dob": "1990-05-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Sign Spirituality Horoscope

Dive into the spiritual essence of your zodiac sign. This horoscope reveals your intuitive strengths, inner guidance patterns, connection to higher consciousness, and the role spirituality plays in your life path.

Endpoint

/horoscope/sign/spirituality

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Used to determine your zodiac sign and generate the personality horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/sign/spirituality"
querystring = {"dob": "1990-05-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Sign Career & Money Horoscope

Tap into your zodiac sign’s influence on career ambition, financial instincts, and prosperity paths. This horoscope offers insights into your professional strengths, wealth mindset, and long-term success patterns.

Endpoint

/horoscope/sign/career_money

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Used to determine your zodiac sign and generate the personality horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/sign/career_money"
querystring = {"dob": "1990-05-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Sign Parent-Child Horoscope

Understand the astrological dynamics between parent and child based on the zodiac sign derived from your date of birth. This horoscope reveals parenting styles, emotional bonding patterns, and how your energy influences or aligns with children.

Endpoint

/horoscope/sign/parent_child

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Used to determine your zodiac sign and generate the personality horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/sign/parent_child"
querystring = {"dob": "1990-05-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Sign Birthday Horoscope

Celebrate your solar return with deep astrological insight into your birthday energy. This horoscope reveals the themes, personal growth opportunities, and spiritual shifts influencing your life during a specific birthday year.

Endpoint

/horoscope/sign/birthday

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth in `YYYY-MM-DD` format. Used to determine your zodiac sign and generate the personality horoscope.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/sign/birthday"
querystring = {"dob": "1990-05-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Career Compatibility Horoscope

Evaluate the professional chemistry between two individuals based on their birth dates and astrological profiles. This horoscope explores how your zodiac energies align in a work or business environment, highlighting collaboration strengths, leadership balance, and productivity patterns.

Endpoint

/horoscope/compatibility/career

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Date of birth of the main person, in `YYYY-MM-DD` format. Used to determine the primary astrological profile.
`dob_partner`	string	✅ Yes	Date of birth of the partner, in `YYYY-MM-DD` format. Assesses compatibility with the main person in terms of career and professional synergy.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/compatibility/career"
querystring = {
"dob": "1990-05-15",
"dob_partner": "1992-08-22"
}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Friendship Compatibility Horoscope

Discover how your zodiac energies align in friendship. This horoscope analyzes compatibility between two individuals, revealing emotional resonance, communication flow, loyalty potential, and how your signs vibe in platonic relationships.

Endpoint

/horoscope/compatibility/friendship

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Date of birth of the main person, in `YYYY-MM-DD` format. Determines their zodiac sign and friendship traits.
`dob_partner`	string	✅ Yes	Date of birth of the friend or partner, in `YYYY-MM-DD` format. Used to calculate the compatibility with the main person.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/compatibility/friendship"
querystring = {
"dob": "1990-05-15",
"dob_partner": "1992-08-22"
}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Love Compatibility Horoscope

Reveal the romantic chemistry and potential challenges between two individuals through the lens of astrology. This horoscope compares zodiac energies to assess emotional connection, passion, trust, and long-term love alignment.

Endpoint

/horoscope/compatibility/love

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Date of birth of the main person, in `YYYY-MM-DD` format. Determines their romantic archetype.
`dob_partner`	string	✅ Yes	Date of birth of the partner, in `YYYY-MM-DD` format. Evaluates compatibility with the main person in love and relationships.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/compatibility/love"
querystring = {
"dob": "1990-05-15",
"dob_partner": "1992-08-22"
}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Astrology Aspects Horoscope

Explore the energetic meanings of key astrological aspects—how planets interact and influence behavior, emotions, and life events. Perfect for deepening your understanding of aspects like conjunction, opposition, trine, and more.

Endpoint

/horoscope/astrology/aspect

Query Parameters

Name	Type	Required	Description
`aspect`	string	✅ Yes	The specific astrological aspect to interpret. Options include: `conjunction`, `opposite`, `square`, `trine`, `sextile`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/astrology/aspect"
querystring = {"aspect": "conjunction"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Astrology Houses Horoscope

Unlock the meaning behind each of the 12 astrological houses, which represent different areas of life—from identity and values to relationships, career, and transformation. Learn how each house influences your personal journey.

Endpoint

/horoscope/astrology/housee

Query Parameters

Name	Type	Required	Description
`house`	string	✅ Yes	The name of the astrological house you want to explore. Options: `first`, `second`, `third`, `fourth`, `fifth`, `sixth`, `seventh`, `eighth`, `ninth`, `tenth`, `eleventh`, `twelfth`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/astrology/house"
querystring = {"house": "eighth"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Astrology Returns Horoscope

Explore powerful astrological return cycles—key moments when planets revisit their original positions in your birth chart. This horoscope reveals how each return (e.g., Solar Return, Saturn Return) marks transformation, growth, or realignment in your life.

Endpoint

/horoscope/astrology/returns

Query Parameters

Name	Type	Required	Description
`returns`	string	✅ Yes	The type of astrological return to interpret. Options: `solar`, `lunar`, `mercury`, `venus`, `mars`, `jupiter`, `saturn`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/astrology/returns"
querystring = {"returns": "solar"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Astrology Terms Info

Get clear, concise definitions and explanations of key astrology terms. Whether you're new to astrology or deepening your practice, this endpoint delivers insightful breakdowns of concepts like transits, rising signs, Vedic astrology, and more.

Endpoint

/horoscope/astrology/term

Query Parameters

Name	Type	Required	Description
`term`	string	✅ Yes	The name of the astrology term you want explained. Options: `astrology`, `sun_sign`, `moon_sign`, `rising_sign`, `transit`, `aspects`, `western_astrology`, `vedic_astrology`, `tibetan_astrology`, `horary_astrology`, `medical_astrology`, `chinese_astrology`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/astrology/term"
querystring = {"term": "transit"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Planets Horoscope

Dive into the symbolic influence of each planet in astrology. This endpoint reveals how celestial bodies like Pluto, Mars, or the Moon affect personality, behavior, energy, and destiny from an astrological perspective.

Endpoint

/horoscope/planets

Query Parameters

Name	Type	Required	Description
`planet_name`	string	✅ Yes	The name of the planet you want interpreted. Options: `sun`, `moon`, `mercury`, `venus`, `mars`, `jupiter`, `saturn`, `uranus`, `neptune`, `pluto`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/planets"
querystring = {"planet_name": "pluto"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Planets In House Horoscope

Understand how the placement of a planet in a specific astrological house shapes personality traits, life themes, and karmic lessons. This reading reveals how a planet's influence is expressed in a particular area of life.

Endpoint

/horoscope/planets/house

Query Parameters

Name	Type	Required	Description
`planet`	string	✅ Yes	The name of the planet to analyze. Options: `sun`, `moon`, `mercury`, `venus`, `mars`, `jupiter`, `saturn`, `uranus`, `neptune`, `pluto`, `ceres`.
`house`	string	✅ Yes	The name of the house the planet occupies. Options: `first`, `second`, `third`, `fourth`, `fifth`, `sixth`, `seventh`, `eighth`, `ninth`, `tenth`, `eleventh`, `twelfth`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/planets/house"
querystring = {
"planet": "saturn",
"house": "third"
}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Mercury Retrograde Horoscope

Mercury retrograde is known for disrupting communication, travel, and technology. This endpoint reveals how Mercury retrograde affects you personally based on your date of birth—helping you navigate the chaos with cosmic clarity.

Endpoint

/horoscope/retrograde/mercury

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	The date of birth of the individual, in `YYYY-MM-DD` format. Used to personalize the Mercury retrograde effects.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/retrograde/mercury"
querystring = {"dob": "1990-08-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Saturn Return Effects

The Saturn Return marks one of life’s most transformative astrological milestones—ushering in a time of maturity, accountability, and purpose. This endpoint provides deep insights into how your Saturn Return will affect you, based on your date of birth.

Endpoint

/horoscope/saturn/returns

Query Parameters

Name	Type	Required	Description
`dob`	string	✅ Yes	Your date of birth, formatted as `YYYY-MM-DD`. Determines when your Saturn Return occurs and what it means for you.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/horoscope/saturn/returns"
querystring = {"dob": "1990-01-15"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Lucky Days Calendar

The Lucky Days Calendar endpoint generates a week-by-week forecast of your luckiest days based on numerological patterns derived from your date of birth. It's ideal for planning key events like job interviews, launches, travel, meetings, or romantic outings when your energetic alignment is at its peak.
Powered by the vibrational influence of your Personal Day Numbers, this calendar offers spiritual guidance for up to 12 weeks, starting from today or a specified date.

Endpoint

/lucky-days-calendar

Query Parameters

Parameter	Type	Required	Description
`dob`	String	Yes	The user’s date of birth in `YYYY-MM-DD` format.
`start_date`	String	No	The starting date of the calendar range in `YYYY-MM-DD`. If omitted, defaults to today.
`weeks`	Number	No	Number of weeks to generate. Accepts up to 12 weeks. Default: `9`.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/lucky-days-calendar"
querystring = {
"dob": "1997-07-17",
"weeks": "9"
}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Capstone Letter

The Capstone Letter in numerology is the final letter of a person's name (usually the first name) and reveals insights into how they complete tasks, their follow-through energy, and their attitude toward closure. This endpoint extracts the Capstone from a given name and returns its deeper metaphysical meaning.
It’s a subtle yet powerful tool for decoding personality tendencies—especially useful for spiritual life coaching, relationship insights, and personal development analysis.

Endpoint

/capstone-letter

Query Parameters

Parameter	Type	Required	Description
`name`	String	Yes	A full name or first name. The Capstone is derived from the last letter of the first word.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/capstone-letter"
querystring = {"name": "John"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Email Numerology Calculator

The Email Numerology Calculator decodes the hidden vibrational energies within an email address using numerological principles. Just like names and birth dates, digital identifiers such as email addresses carry unique energetic imprints that can influence personal brand presence, communication style, and digital karma.

This endpoint breaks down the core number associated with an email and reveals its underlying metaphysical meaning. Perfect for spiritual entrepreneurs, digital creators, or anyone curious about the energy behind their digital identity.

Endpoint

/email-numerology

Query Parameters

Parameter	Type	Required	Description
`email`	String	Yes	The email address you want to analyze. The address is converted into a numerical vibration and interpreted through the lens of numerology.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/email-numerology"
querystring = {"email": "project@dakidarts.com"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Date Meaning Calculator

The Date Meaning Calculator decodes the spiritual and numerological significance of any specific calendar date. Whether you're selecting an important date for an event, planning a launch, or simply curious about the energy surrounding a past or future date—this tool reveals the hidden numerology vibration and symbolic meaning behind it.

By reducing the date to a single-digit core number or a master number (11, 22, 33), it uncovers themes such as intuition, transformation, creativity, karma, and cosmic timing. A powerful tool for conscious decision-making and divine planning.

Endpoint

/date-meaning

Query Parameters

Parameter	Type	Required	Description
`date`	String	Yes	The date to analyze, formatted as `YYYY-MM-DD`. The system will return its numerological reduction and metaphysical interpretation.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/date-meaning"
querystring = {"date": "2025-12-21"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Cornerstone Letter Calculator

The Cornerstone Letter Calculator reveals the first letter of a person's name, known in numerology as the Cornerstone Letter. This letter reflects an individual’s natural approach to beginnings, initial reactions, and attitude toward new opportunities and challenges.

It provides insight into how a person tackles life’s starting points—like new jobs, relationships, or projects—offering a glimpse into their instinctual drive, energetic tone, and foundational personality traits.

The Cornerstone is essential in name numerology, as it sets the vibrational stage for how one navigates the unknown and initiates progress.

Endpoint

/cornerstone-letter

Query Parameters

Parameter	Type	Required	Description
`name`	String	Yes	The individual’s full name or first name. The first alphabetic letter of the first word is extracted and analyzed.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/cornerstone-letter"
querystring = {"name": "John"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Ancestor Attributes Reading

The Ancestor Attributes Reading delves into the energetic and spiritual legacy encoded in your family name, surname, clan, or ancestral identifier. By interpreting the vibrational essence of your last name, this tool uncovers inherited attributes, ancestral strengths, karmic imprints, and core family values that may influence your life path and soul journey.

Rooted in name numerology and spiritual anthropology, this reading is a bridge to the wisdom of your bloodline—offering guidance, protection, and insight into ancestral gifts and spiritual missions passed down through generations.

Endpoint

/ancestor-reading

Query Parameters

Parameter	Type	Required	Description
`family_name`	String	Yes	The surname, clan name, or ancestral identifier to be analyzed for vibrational meaning.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/ancestor-reading"
querystring = {"family_name": "Etuge"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Personal Month Number Calculator

The Personal Month Number is a powerful numerological tool used to forecast the energies and themes influencing you during a specific month. Derived from your date of birth and the target date, this number reveals spiritual lessons, opportunities, and challenges you may face that month. It’s ideal for planning, manifestation alignment, and emotional awareness throughout your calendar cycle.

Whether you're navigating career decisions, relationships, or spiritual growth, this number helps attune you to the vibrational flow of time, giving you deeper clarity and guidance.

Endpoint

/personal-month

Query Parameters

Parameter	Type	Required	Description
`dob`	String	Yes	Your date of birth in `YYYY-MM-DD` format.
`target_date`	String	No	Any day within the desired month to calculate. Format: `YYYY-MM-DD`. Defaults to today's date.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/personal-month"
querystring = {"dob": "1997-07-17"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Personal Day Number Calculator

The Personal Day Number is one of the most time-sensitive numerological tools. It helps you understand the specific energy, mood, and spiritual vibration of today (or any target date you choose). Based on your date of birth, it gives profound insight into how the Universe is aligning for you on that day.

This number offers daily guidance for decision-making, creativity, rest, productivity, or connection — helping you to flow with the rhythm of cosmic timing instead of pushing against it. Ideal for spiritual alignment, intuitive journaling, and energetic preparation.

Endpoint

/personal-day

Query Parameters

Parameter	Type	Required	Description
`dob`	String	Yes	Your date of birth in `YYYY-MM-DD` format.
`target_date`	String	No	The day to analyze. Format: `YYYY-MM-DD`. Defaults to today's date.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/personal-day"
querystring = {"dob": "1997-07-17"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Personal Day Affirmations

This endpoint generates a daily affirmation message based on your Personal Day Number, derived from your date of birth and the current or specified date. Each affirmation is energetically aligned with the vibration of the day, empowering you to harmonize your thoughts, emotions, and intentions with the universal numerological current.

These affirmations are great for spiritual journaling, meditation, daily rituals, wellness apps, and self-empowerment tools — allowing individuals to start each day grounded in cosmic clarity and divine synchronicity.

Endpoint

/personal-day-affirmations

Query Parameters

Parameter	Type	Required	Description
`dob`	String	Yes	The user's date of birth in `YYYY-MM-DD` format.
`target_date`	String	No	Date to generate affirmation for (format: `YYYY-MM-DD`). Defaults to today's date.

Python Requests Example:

import requests
url = "https://the-numerology-api.p.rapidapi.com/personal-day-affirmations"
querystring = {"dob": "1997-07-17"}
headers = {
"x-rapidapi-host": "the-numerology-api.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Subscribe to the Numerology API

Subscribe on RapidAPI

Head over to our API listing on RapidAPI and click the “Subscribe” button. Choose a plan that fits your needs — from free testing to full-scale production.

Get Your API Key

Once subscribed, grab your unique X-RapidAPI-Key from the "Endpoints" tab. You’ll use this key to authenticate all your requests securely.

Start Making Requests

Use the provided code snippets or integrate directly into your app. Send requests to any available endpoint and enjoy seamless access to our powerful API features.

Got any questions or issues with our API? Please don’t hesitate to contact us!