DEV Community

Cover image for I Built an Astrology API With 100+ Endpoints
Oleg K
Oleg K

Posted on

I Built an Astrology API With 100+ Endpoints

If you've ever tried adding astrology features to an app, you know the pain.

Most APIs on the market give you daily horoscopes for 12 zodiac signs and charge $30+/month for the privilege. Need natal charts? Synastry? Hellenistic techniques? Good luck — you're stitching together 3 different services, writing custom calculation logic, and still getting 2-3 second response times.

We built Astrology API to fix that.

What Astrology API Actually Does

One API. 100+ calculation types. Here's a quick breakdown:

Category What You Get
Raw Data Planetary positions, house cusps (23 systems), aspects, lunar metrics, eclipses
Chart Analysis Natal, synastry, composite, transit, solar return, lunar return, progressions
Hellenistic Essential dignities, annual profections, Arabic parts (97+), sect analysis
Astrocartography Planetary lines on world maps, relocation scoring, parans
Reports AI-powered interpretations for natal, synastry, career, life areas — in 9+ languages
Horoscopes Daily/weekly/monthly/yearly — sun-sign AND personalized
Numerology Pythagorean + Chaldean systems, life path, expression numbers
Visual Charts SVG natal wheels, aspect grids, astrocartography maps

A Quick Example

Get a full natal chart with one call:

curl -X POST https://astrology-api.io/api/v1/natal-chart \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-06-15",
    "time": "14:30",
    "location": "New York"
  }'
Enter fullscreen mode Exit fullscreen mode

That's it. No timezone lookups, no coordinate conversions. Pass a city name — we handle geocoding automatically.

Response time? Under 300ms for this. Competitors typically take 2-5 seconds for the same calculation.

How It Compares

Here's the honest comparison:

Feature Astrology API DivineAPI ($31-49/mo) Bloom.be (€29-279/mo)
Calculation types 100+ ~15 ~30
House systems 23 1 4
Hellenistic techniques Yes No No
Fixed stars 50+ No Basic
Arabic parts 97+ No No
Response time <300ms 1-3s 2-5s
AI interpretations Yes Limited No
Languages 9+ 1 3
Free tier 50 req/mo No No
Popular plan $21/mo $31/mo €29/mo

Why Developers Actually Use This

1. Zero Astrology Knowledge Required

Every endpoint has a built-in glossary system. Your frontend devs don't need to know what "annual profections" are — the API returns human-readable labels and explanations alongside raw data.

2. The Documentation Is Actually Good

Interactive API docs via RapiDoc, plus a Postman collection with 113+ pre-built examples. Import it and start testing in 30 seconds.

3. It Scales

No hard request caps that suddenly break your app. Batch processing for bulk operations. Webhook support for async calculations. The architecture handles spikes without you thinking about it.

4. AI-Powered Interpretations

Raw planetary data is great for astrology nerds. But if you're building a consumer app, you need readable content. Our interpretation engine uses LLMs to generate personalized, nuanced reports — not the generic "Mercury is in retrograde" copy-paste.

Who's Using It

Pricing

We kept it simple:

  • Free: 50 requests/month (enough to prototype)
  • Pro: $11/mo — 1,000 requests
  • Pro Plus: $21/mo — 7,000 requests (most popular)
  • Ultra: $37/mo — 55,000 credits, all 23 house systems
  • Business: $99/mo — 220,000 credits, all endpoints
  • Enterprise: $399+/mo — unlimited, dedicated infrastructure

Higher tiers unlock more house systems and advanced features. No credit card required for the free tier.

Get Started

  1. Sign up at astrology-api.io
  2. Get your API key (instant, no credit card for free tier)
  3. Hit your first endpoint
# Test it right now — planetary positions for today
curl https://astrology-api.io/api/v1/planets/now \
  -H "Authorization: Bearer YOUR_API_KEY"
Enter fullscreen mode Exit fullscreen mode

The free tier gives you 50 requests/month — enough to build a proof of concept and see if it fits your use case.


If you're building anything that touches astrology, numerology, or cosmic timing — give it a try. Happy to answer questions in the comments.


Useful links:

Top comments (0)