Introduction
The MyCosmicAdvisor API allows you to integrate astrological blueprint generation into your applications. Generate complete natal charts, Human Design profiles, and AI-powered interpretations programmatically.
Available Endpoints
1. Modular Blueprint Generation
POST /api/v1/generate-blueprint - Flexible module selection with optional AI (4-684 credits)
Generate a comprehensive astrological profile with full control over which modules to include and which get AI interpretations:
- Astrology Module: Complete natal chart (1 credit data, +380 credits for AI)
- Human Design Module: Type, centers, gates, channels, profile (2 credits data, +280 credits for AI)
- Numerology Module: Life path numbers and cycles (1 credit data, +20 credits for AI)
Flexible AI Generation: Choose which modules get AI interpretations (per-module, not per-section)
2. Transit Analysis
POST /api/v1/transits - Calculate astrological transits (variable pricing)
Analyze planetary transits for any birth chart:
- Daily Transits: Current day analysis (1 credit)
- Weekly Transits: 7-day forecast (2 credits)
- Monthly Transits: 30-day forecast (3 credits)
- Optional AI Interpretation: Add +20 credits for detailed AI insights (defaults to no AI)
3. Quick Calculators
1 credit each - Fast, lightweight calculations:
POST /api/v1/calculators/life-path: Calculate Life Path numberPOST /api/v1/calculators/big-3: Calculate Sun, Moon, Rising signsPOST /api/v1/calculators/natal-chart: Complete natal chart (data only, no AI)
4. Daily Horoscopes
1 credit - AI-generated daily horoscopes:
GET /api/v1/horoscope/:sign: Single zodiac sign horoscopeGET /api/v1/horoscope/all: All 12 signs in one request (same 1 credit!)
Pricing (Credits)
Blueprint Generation (Modular)
DATA COSTS (always charged for selected modules):
| Module | Data Cost | AI Cost (optional) | Sections |
|---|---|---|---|
| Astrology | 1 credit | +380 credits | 19 AI sections |
| Human Design | 2 credits | +280 credits | 14 AI sections |
| Numerology | 1 credit | +20 credits | 1 AI section |
Examples:
- All data only (no AI):
4 credits(1+2+1) - Astrology data + AI:
381 credits(1+380) - All data + Astrology AI only:
384 credits(1+2+1+380) - All data + ALL AI:
684 credits(1+2+1+20+380+280) - Numerology only (data + AI):
21 credits(1+20)
Quick Calculators
| Calculator | Credits | What's Included |
|---|---|---|
| Life Path | 1 | Life Path number + description |
| Big Three | 1 | Sun, Moon, Rising signs + descriptions |
| Natal Chart | 1 | Complete chart data (no AI interpretations) |
Transit Analysis
| Period | Data Only | With AI (+20) |
|---|---|---|
| Daily | 1 credit | 21 credits |
| Weekly | 2 credits | 22 credits |
| Monthly | 3 credits | 23 credits |
Daily Horoscopes
| Endpoint | Credits | Note |
|---|---|---|
| Single Sign | 1 | One zodiac sign |
| All Signs | 1 | All 12 signs (92% savings!) |
Coming Soon
| Feature | Status | Description |
|---|---|---|
| Synastry Analysis | Planned | Relationship compatibility between two birth charts |
| AI Consultations | Planned | Interactive Q&A with AI astrologer about your chart |
| Chart Comparison | Planned | Side-by-side analysis of multiple charts |
Getting Started
- Create an API key from your dashboard
- Purchase credits from your credits page
- Make your first API call using the examples in this documentation
Base URL
https://mycosmicadvisor.com/api/v1
All API requests must be made over HTTPS.