Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 

Repository files navigation

The Numerology API

The Numerology API Cover

Docs Live Dashboard Platform RapidAPI

Version v1.0.2 220+ endpoint pages 26 supported languages Swiss Ephemeris powered engine

The Numerology API by Dakidarts is an enterprise-grade numerology, horoscope, astrology, and divination API for production apps, SaaS products, bots, dashboards, and spiritual intelligence experiences.

The current platform exposes 220+ API endpoints, including 130+ horoscope routes, direct API key access, credit-based billing, 26-language localized response support, and multi-system numerology across Pythagorean, Chaldean, and Vedic calculations.


v1.0.2 - Extended 26-Language Release

Latest Release

v1.0.2 - Extended 26-Language Release

Released on June 19, 2026, v1.0.2 expands the direct API platform with 10 more extended endpoint families, full 26-language response coverage, and continued multi-system numerology support through num_sys where letter-based identity is part of the calculation.

Highlights:

  • 26 supported response languages: en, es, de, fr, pt, ar, hi, ja, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh
  • Multi-system numerology: pythagorean, chaldean, vedic
  • 10 new v1.0.2 endpoint families for relationship milestones, relocation fit, vehicle identity, phone-number personal fit, signatures, pets, creative projects, family legacy, education paths, and travel destination alignment
  • Production validation: expanded localized JSON meanings, endpoint contracts, dashboard docs, command palette discovery, and public docs refreshed for v1.0.2

Read the full release notes: v1.0.2 changelog

Core Capabilities

  • Numerology Intelligence: Life path, destiny/expression, soul urge, personality, balance, karmic lessons, cycles, bridge numbers, name readings, compatibility, timing, and extended spiritual analysis.
  • Multi-System Name Numerology: Pythagorean by default, with optional Chaldean and Vedic systems via num_sys.
  • Horoscope and Astrology: Daily, weekly, monthly, yearly, planetary, zodiac, compatibility, astrology report, transit, aspect, house, and chart-oriented endpoints.
  • Business and Product Readings: Business names, brand comparisons, product names, domain names, launch timing, decision analysis, and wealth/career readings.
  • Relationship and Family Readings: Relationship composites, healing readings, parent-child numerology, team dynamics, and soul connection indicators.
  • Multilingual Output: Supported numerology/helper responses can use any of the 26 supported language codes, including en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, and zh.
  • Production Operations: API keys, dashboard access, credits, usage visibility, internal docs, and direct-host deployment at api.numerologyapi.com.

Example Request

curl -X GET "https://api.numerologyapi.com/api/v1/career-path-numerology?full_name=Ada%20Lovelace&dob=1815-12-10&current_role=Mathematician&num_sys=chaldean&lang=fr" \
  -H "X-API-Key: YOUR_API_KEY"

POST requests also support lang in the query string and num_sys in the JSON body where the endpoint supports numerology systems.

v1.0.2 Endpoint Families

The v1.0.2 release adds these direct API endpoint families:

Endpoint Methods Purpose
/api/v1/relationship-milestone-numerology GET, POST Milestone-specific relationship resonance from two people and a key relationship date
/api/v1/relocation-compatibility GET, POST Symbolic fit between a person and a city, country, address, or move date
/api/v1/vehicle-identity-numerology GET, POST Vehicle plate, name, purchase date, and owner-profile identity reading
/api/v1/phone-number-personal-fit GET, POST Phone-number vibration fit against name and birth profile
/api/v1/signature-numerology GET, POST Signature, initials, title, or public-name alignment against a legal name
/api/v1/pet-name-harmony GET, POST Pet-name and household-fit reading for companion animals
/api/v1/creative-project-numerology GET, POST Creative title, creator profile, release date, and audience-goal alignment
/api/v1/family-legacy-matrix GET, POST Family-system report from surname, member names, dates, and roles
/api/v1/education-path-numerology GET, POST Learner, field of study, institution, and enrollment timing fit
/api/v1/travel-destination-alignment GET, POST Traveler-to-destination resonance by dates and trip purpose

v1.0.1 Endpoint Families

The v1.0.1 release adds these direct API endpoint families:

Endpoint Methods Purpose
/api/v1/career-path-numerology GET, POST Career strengths, work style, and professional alignment
/api/v1/wealth-code-reading GET, POST Money pattern, earning style, and prosperity lessons
/api/v1/home-address-numerology GET, POST Home or location vibration analysis
/api/v1/baby-name-forecast GET, POST Baby-name candidate comparison and family harmony
/api/v1/team-dynamics-numerology GET, POST Team mission, member balance, and collaboration dynamics
/api/v1/domain-name-numerology GET, POST Domain-name vibration and brand-fit insights
/api/v1/product-name-numerology GET, POST Product, app, offer, or feature-name alignment
/api/v1/decision-crossroads-reading GET, POST Option comparison for major decisions
/api/v1/launch-timing-numerology GET, POST Date scoring for launches and releases
/api/v1/personal-archetype-stack GET, POST Combined archetype profile from name and birth data

Documentation


Access channels

Direct platform access

For the newest and most advanced platform capabilities, use:

  • Base URL: https://api.numerologyapi.com
  • Auth: X-API-Key: YOUR_API_KEY
  • or Authorization: Bearer YOUR_API_KEY

RapidAPI

Marketplace access remains available for supported public surfaces on RapidAPI:

Some newer and extended releases are direct-platform only and are not fully mirrored through RapidAPI.


Example use cases

The Numerology API is built for products such as:

  • mobile numerology apps
  • astrology and horoscope apps
  • dashboard products
  • personalized PDF/report generators
  • compatibility tools
  • spiritual coaching software
  • Telegram and WhatsApp bots
  • browser extensions
  • WordPress integrations
  • content automation and SEO engines
  • SaaS products that need symbolic or timing-based intelligence

Ecosystem

Documentation site

A dedicated docs platform with structured navigation, examples, changelogs, and release pages:

Numerology dashboard

Manage access, keys, credits, and usage:

Numerology bot

Official bot experience powered by the platform:

WordPress plugin

Free plugin for bringing numerology insights into WordPress sites:

Firefox extension

Numerology Report Generator Pro:


Open-source astrology engine (Python library + CLI)

If you want a lightweight, open-source astrology stack outside the full hosted platform, use OpAstro.

OpAstro is our open-source astrology engine for Python developers and indie astrologers:

  • Python library + CLI interface

  • lightweight sibling of our main production horoscope engine

  • built for local workflows, scripting, and indie product integration

  • practical for developers who want direct control and self-managed usage

  • Repo: https://github.com/dakidarts/opastro

  • Site: https://opastro.com/

If OpAstro helps your work, please star the repo. GitHub stars help the algorithm recommend the project to more builders.


Authority and release discipline

This platform has evolved through continuous releases from early public numerology tooling into a broader intelligence platform with:

  • 220+ documented endpoint/reference pages in the current release docs
  • direct-platform and marketplace distribution
  • versioned changelogs and release documentation
  • enterprise-style metadata wrappers
  • multilingual validation across supported surfaces
  • an internal horoscope engine replacing dependence on legacy third-party flows

v1.0.2 marks the current release line for expanded direct API coverage, 26-language response support, and production-ready multi-system numerology.


Repository purpose

This GitHub repository serves as the public-facing home for:

  • project identity and platform overview
  • release visibility
  • ecosystem links
  • documentation entry points
  • product credibility and technical positioning

If you are looking to integrate the API, start with the docs and dashboard rather than the repository itself.


Getting started

1) Open the docs

Start here:

2) Create or access your account

Open the dashboard:

3) Pick your access path

Choose between:

  • direct platform access for the newest and extended surfaces
  • RapidAPI for supported marketplace surfaces

4) Test endpoints

Use the documentation examples and reference pages to begin integrating.


Selected feature timeline

Early platform foundation

The platform started with core numerology, zodiac sign intelligence, and major horoscope sections.

Birth charts and visual astrology

Added:

  • /birth-chart
  • /birth-chart/svg

Tarot surfaces

Added tarot reading endpoints for multi-card and power-card use cases.

Advanced numerology releases

Expanded into:

  • hidden passion positions
  • mirror numbers
  • essence cycles
  • bridge numbers
  • compatibility systems
  • angel number synchronicities
  • personal hour
  • lifecycle and timing intelligence

v0.1.1

Expanded themed, human-centered response quality and companion ecosystem tooling.

v1.0.0

Unified release for major numerology and horoscope expansion, documentation maturity, route normalization, and in-house engine authority.


Brand and philosophy

The Numerology API is built at the intersection of:

  • symbolic intelligence
  • developer usability
  • structured automation
  • spiritual tooling
  • production-grade delivery

It is designed to help builders create products that are not only functional, but meaningful.

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


Stay connected


License and contribution

This repository is primarily a public project and platform-facing repository.

For platform usage, integration, and endpoint access, use the official docs and dashboard. For collaboration or partnership opportunities, reach out through Dakidarts channels.


Build with numbers. Ship with clarity. Scale with structured cosmic intelligence.

About

Embark on a cosmic journey with our enhanced Astro-Numerology API. Beyond the profound insights of Pythagorean numerology, our API now seamlessly integrates horoscope and zodiac features, offering a holistic view of the mystical forces shaping individuals' lives.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors