One API · Every tradition

The numerology, astrology & divination API for builders

208+ calculators across 12 traditions, returned as clean JSON. Swiss Ephemeris accuracy. An API key in seconds.

100 free calls/month · no card required · live in minutes

POST /api/v1/calculator/life_path_number
# one endpoint, every calculator
curl -X POST https://dev.numroq.com/api/v1/calculator/abjad \
  -H "X-API-Key: nmq_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "محمد"}'

# => clean, structured JSON
{
  "calculation_type": "abjad",
  "result": {
    "total_kabir": 92,
    "dominant_planet": "Mercury",
    "dominant_element": "Fire"
  }
}
208+ calculators
12 traditions
Swiss Ephemeris accuracy
1 REST API
JSON in, JSON out

Why NumroQ

Ancient systems, engineered precisely

Everything you need to ship numerology, astrology and divination features - without building the math yourself.

Every tradition, one API

Abjad, Vedic, Western astrology, Chaldean, Kabbalah, Chinese, Greek, Matrix of Destiny and more - a single consistent endpoint.

🌌

Real astronomical accuracy

Charts, transits and planetary positions use the Swiss Ephemeris - the engine trusted by professional astrology software.

Instant, structured JSON

Every calculator returns predictable JSON under result. No scraping, no parsing HTML, no surprises.

🔑

Keys in seconds

Sign up, copy your X-API-Key, and make your first call. Per-key domain and IP allow-lists included.

🔌

WordPress plugin

Drop calculators onto any WordPress site with a shortcode. Your key stays server-side, never in the browser.

🌐

White-label website

Not a developer? Launch a complete, self-hosted numerology site on your own domain and brand it as your own.

The catalogue

208+ calculators, 12 traditions

From a single name's Abjad value to a full Vedic Kundli with Vimshottari Dasha - it's all one API.

Islamic / Abjad25
Vedic / Jyotish15
Astrology (W & V)56
Western Numerology26
Chaldean8
Jewish / Kabbalah9
Chinese / East Asian15
Greek / Hermetic7
Modern / Matrix16
World Traditions9
Utility / Converters14
Divination & Mystic8
Browse every calculator →

Built for developers

Call it from anything

Plain HTTP with an API-key header. Use cURL, Python, JavaScript or any language that speaks REST.

python
import requests

r = requests.post(
    "https://dev.numroq.com/api/v1/calculator/life_path_number",
    headers={"X-API-Key": "nmq_live_your_key"},
    json={"birth_date": "1990-05-15"},
)
data = r.json()["result"]
print(data["life_path_number"], data["title"])   # 3  The Communicator

Simple pricing

Start free, scale when you grow

No setup fees, no contracts. Pay only for the call volume you need.

Free
$0
forever
  • 100 calls / month
  • API key included
  • All 208+ calculators
  • Instant access
Popular
Starter
$19/mo
for launching
  • 1,500 calls / month
  • Priority support
  • Usage analytics
  • Everything in Free
Growth
$49/mo
for scaling
  • 10,000 calls / month
  • Advanced analytics
  • Higher rate limits
  • Everything in Starter
Pro
$99/mo
for production
  • 50,000 calls / month
  • Dedicated support
  • Custom limits available
  • Everything in Growth
Full pricing & licences →

Questions

Frequently asked

What is the NumroQ API?

A single REST API that returns numerology, astrology and divination results as structured JSON - 208+ calculators across 12 traditions, from Abjad and Vedic numerology to full Western and Vedic natal charts, tarot, and more.

How accurate are the astrology calculators?

Chart, planet and transit calculations use the Swiss Ephemeris for real astronomical precision - the same engine professional astrology software relies on. Numerology and divination tools follow the classical rules of each tradition.

Is there a free tier?

Yes. Every account includes 100 free API calls per month with an API key issued instantly - no card required. Paid plans start at $19/month for 1,500 calls.

Can I use it commercially?

Absolutely. Build and sell your own apps, websites and widgets on top of the API. There is also a WordPress plugin for shortcodes and a self-hosted white-label website for non-developers.

What do responses look like?

Every calculator returns JSON with the calculation under a result object, plus your plan and remaining quota. The shape of result is documented per calculator in the docs.

Ready when you are

Ship your first calculation today

Free key, 208+ calculators, one API. It takes about two minutes.

Get your free API key