The Numerology API is a production-ready numerology and astrology platform for developers, founders, spiritual products, content systems, bots, and report-driven apps.
It combines core numerology, extended numerology intelligence, birth charts, horoscope reports, compatibility systems, timing endpoints, and an in-house horoscope engine into one unified developer platform.
Most numerology or astrology APIs stop at raw calculations or thin summaries.
The Numerology API goes further with:
- structured and integration-friendly JSON responses
- deep endpoint coverage across numerology, astrology, horoscope, tarot, and symbolic systems
- multilingual support across major surfaces
- direct platform access for premium and extended releases
- an in-house horoscope engine built for deterministic, production-grade report generation
- developer-ready documentation, dashboard access, and real rollout discipline
This repository is the public home of the platform, release history, ecosystem tooling, and product direction.
v1.0.0 is the platform’s most important release so far.
It brings together two major expansion tracks:
- 23 new extended endpoint families
- 41 new GET/POST operations
- personal week and universal day/week/month/year coverage
- deeper spiritual, identity, relationship, and shadow-analysis endpoints
- 100% multilingual smoke validation across
en,es,de,fr,pt
- major migration of horoscope reports to the in-house Swiss Ephemeris engine
- canonical report namespace under
/api/v1/horoscope/reports/* - new planetary, aspects, transits, house, and planet-house report suites
- broader daily, weekly, monthly, and yearly section coverage
- tighter request and response parity across upgraded report surfaces
- stronger POST-first request structure for upgraded routes
- richer report payloads and metadata wrappers
- better docs parity and migration clarity
- improved production readiness for direct-platform consumers
📘 Read the full changelog:
https://docs.numerologyapi.com/changelog/changelog-v1-0-0/
Build with powerful numerology endpoints for:
- life path
- destiny / expression
- heart desire / soul urge
- personality
- maturity
- balance
- rational thought
- hidden passion
- ancestor reading
- capstone / cornerstone
- compatibility score
- angel number synchronicity
- gematria
- and more
Use timing and forecasting tools such as:
- personal year
- personal month
- personal day
- personal week
- personal hour
- universal year
- universal month
- universal week
- universal day
- monthly energy heatmap
- caution dates calendar
- lucky days calendar
- personal cycle report
Expand beyond basic numerology with advanced endpoints like:
- username numerology
- business name numerology
- brand name compare
- name change impact
- relationship composite
- relationship healing reading
- parent child numerology
- soul contract reading
- soul connection indicator
- aura frequency reading
- chakra numerology
- sacred balance reading
- shadow work number
- spiritual gifts reading
- past life patterns
Access a much broader astrology stack, including:
- daily / weekly / monthly / yearly horoscope reports
- career, love, health, money, friendship, communication, and lifestyle sections
- sign intelligence endpoints
- birth chart JSON
- birth chart SVG
- aspects reports
- planetary reports
- transit reports
- house reports
- planet-in-house reports
- compatibility and astrology reference surfaces
- Docs: https://docs.numerologyapi.com/
- Main platform: https://numerologyapi.com/
- Dashboard: https://dashboard.numerologyapi.com/
The docs site includes:
- 203+ documented endpoint/reference pages
- code snippets and integration examples
- changelog and release notes
- extension and plugin docs
- direct platform guidance for premium surfaces
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
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.
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
A dedicated docs platform with structured navigation, examples, changelogs, and release pages:
Manage access, keys, credits, and usage:
Official bot experience powered by the platform:
Free plugin for bringing numerology insights into WordPress sites:
Numerology Report Generator Pro:
- GitHub: https://github.com/dakidarts/numerology-report-generator-pro
- Firefox Add-ons: https://addons.mozilla.org/en-US/firefox/addon/numerology-report-generator/
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
-
Site: https://opastro.com/
If OpAstro helps your work, please star the repo. GitHub stars help the algorithm recommend the project to more builders.
This platform has evolved through continuous releases from early public numerology tooling into a broader intelligence platform with:
- 203+ 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.0 marks the transition from “feature collection” to structured platform architecture.
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.
Start here:
Open the dashboard:
Choose between:
- direct platform access for the newest and extended surfaces
- RapidAPI for supported marketplace surfaces
Use the documentation examples and reference pages to begin integrating.
The platform started with core numerology, zodiac sign intelligence, and major horoscope sections.
Added:
/birth-chart/birth-chart/svg
Added tarot reading endpoints for multi-card and power-card use cases.
Expanded into:
- hidden passion positions
- mirror numbers
- essence cycles
- bridge numbers
- compatibility systems
- angel number synchronicities
- personal hour
- lifecycle and timing intelligence
Expanded themed, human-centered response quality and companion ecosystem tooling.
Unified release for major numerology and horoscope expansion, documentation maturity, route normalization, and in-house engine authority.
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.”
- Website: https://numerologyapi.com/
- Docs: https://docs.numerologyapi.com/
- Dashboard: https://dashboard.numerologyapi.com/
- RapidAPI: https://rapidapi.com/dakidarts-dakidarts-default/api/the-numerology-api
- X: https://x.com/dakidarts/
- GitHub: https://github.com/dakidarts/the-numerology-api
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.