Developer API

Integrate our AI-powered astrology, human design, and numerology engine into your applications. Build cosmic experiences for your users with our RESTful API.

Get API Keys View Documentation

Why Use Our API?

Skip Years of Development

Building accurate astrology calculations, AI content generation, and multi-system integration takes years. We've done it for you.

Production-Ready AI

Our AI generates personalized, accurate interpretations trained on professional astrological knowledge - no prompt engineering required.

Affordable Credits

Pay only for what you use. No monthly subscriptions, no minimums. Same credit system we use for our own products.

Core API Capabilities

Complete Blueprint Generation

Generate full cosmic blueprints combining Astrology, Human Design, and Numerology

Modular system - choose 1, 2, or all 3 systems
Data-only or AI-interpreted content
Precise astronomical calculations via Swiss Ephemeris
Google Maps geocoding for accurate birth locations
34 sections of insights when fully generated
JSON response with structured data

Individual System Components

Access each system independently for specialized use cases

Astrology: Complete natal chart with planets, houses, aspects
Human Design: Type, centers, gates, channels, profile
Numerology: Life path, expression, soul urge, and more
Mix and match systems based on your needs
Lower credit cost for single systems
Same quality calculations as full blueprints

Personal Horoscope

Calculate personalized horoscope reports for any date and time period

Daily, weekly, or monthly horoscope
Current planetary positions and aspects
Lunar phase tracking and calculations
Transit-to-natal aspect analysis
Optional AI interpretation
Perfect for timing features in your app

How It Works

Get API Keys

Create API keys in your dashboard. Name them by environment or project.

Add Credits

Purchase credit packs just like regular users. Same affordable pricing.

Integrate API

Simple RESTful endpoints with JSON requests/responses. Full documentation provided.

Build & Launch

Create amazing cosmic experiences for your users. Credits deducted per API call.

Transparent Credit Pricing

Same credit system as our web app. Pay only for what you use. No monthly fees, no minimums, no surprises.

Blueprint Components

•Numerology (data): 1 credit
•Astrology (data): 2 credits
•Human Design (data): 2 credits
•Numerology + AI: 21 credits
•Astrology + AI: 382 credits
•Human Design + AI: 282 credits
•Complete Blueprint (all 3 + AI): 680 credits

Transits

•Daily (data): 1 credit
•Weekly (data): 2 credits
•Monthly (data): 3 credits
•Daily + AI: 21 credits
•Weekly + AI: 22 credits
•Monthly + AI: 23 credits

View Credit Pack Pricing

Who Uses Our API?

Astrology Apps

Add birth chart generation, transit tracking, and AI interpretations to your mobile or web app

Example: Daily horoscope app with personal horoscopes

Dating Platforms

Enhance matchmaking with cosmic compatibility analysis and relationship insights

Example: Compatibility scores and synastry for matches

Wellness Platforms

Integrate Human Design insights for personalized health and lifestyle recommendations

Example: Optimal workout timing based on transits

Life Coaching Apps

Provide clients with cosmic guidance, timing insights, and personalized reports

Example: Career coaching with birth chart insights

E-commerce Sites

Offer personalized cosmic reports as products or value-add for existing offerings

Example: Birth chart jewelry with full report

Content Platforms

Generate personalized cosmic content for your audience at scale

Example: Automated personalized weekly forecasts

Developer Experience

Simple Integration

RESTful API designed for ease of use

RESTful endpoints: Standard HTTP methods (POST, GET)
JSON everywhere: Request and response bodies in clean JSON
Bearer token auth: Simple API key authentication
Predictable responses: Consistent error handling and status codes
No SDKs required: Works with any HTTP client in any language

Production Ready

Built for scale and reliability

99.9% uptime: Hosted on Vercel with global edge network
Rate limiting: Automatic throttling to prevent abuse
Error handling: Clear error messages with troubleshooting hints
Credit tracking: Real-time credit balance and usage monitoring
Key management: Create, revoke, and monitor multiple API keys

Quick Example

Generate a complete blueprint with AI interpretation in one API call:

// POST /api/v1/generate-blueprint-modular
{
  "birthDate": "1990-01-15",
  "birthTime": "14:30",
  "city": "New York",
  "country": "USA",
  "latitude": 40.7128,
  "longitude": -74.0060,
  "timezone": "America/New_York",
  "fullName": "John Doe",
  "modules": {
    "numerology": true,
    "astrology": true,
    "humanDesign": true
  },
  "saveToAccount": false
}

// Response (200 OK)
{
  "success": true,
  "blueprintId": "bp_abc123...",
  "data": {
    "numerology": { /* ... */ },
    "astroData": { /* ... */ },
    "humanDesign": { /* ... */ },
    "content": {
      "numerology": { /* AI-generated sections */ },
      "astrology": { /* AI-generated sections */ },
      "humanDesign": { /* AI-generated sections */ }
    }
  },
  "creditsUsed": 680,
  "creditsRemaining": 4360
}

View Full API Documentation

Common Questions

Do I need a paid plan to use the API?

No! There are no monthly fees or subscription plans. Just create a free account, buy credits, generate API keys, and start building. You pay the same per-credit cost as our web app users.

How do API keys and credits work?

API keys are tied to your account and use your credit balance. Create keys in your dashboard, name them by project/environment, and use them in your API requests. Credits are deducted on each successful API call based on what you generate.

Can I use the API commercially?

Yes! Use our API in commercial applications, resell cosmic reports, integrate into paid products - whatever you need. No additional licensing fees. Just pay for the credits you use.

What about rate limits?

Reasonable rate limits are in place to prevent abuse (100 requests/minute per key). If you need higher limits for high-volume use cases, contact us to discuss enterprise options.

Is there a sandbox/test environment?

Every API call uses real credits - there is no separate sandbox. However, we recommend creating a separate API key for development/testing and using low-credit endpoints (data-only blueprints) during development.

What if I have questions or need support?

Full API documentation is available at /api-docs. For additional support, developer questions, or feature requests, contact us through the dashboard support section.

Can you store blueprints for me?

Yes! Set saveToAccount: true in your API requests to permanently save blueprints to your account. You can then retrieve them later via /api/blueprints/list and /api/blueprints/:id endpoints. Perfect for building user dashboards.

Do you offer bulk discounts?

Large credit packs already include significant discounts (up to 30% off). For enterprise-scale usage (1M+ credits/month), contact us to discuss custom pricing.

Ready to Build Something Cosmic?

Get your API keys and start integrating AI-powered astrology into your application today

Get API Keys Read Documentation

Back to Resources