# AstroAPI

> The fastest, most accurate astrology API for developers. 100+ endpoints, <300ms response time, 23 house systems, Swiss Ephemeris precision.

AstroAPI provides professional-grade astrological calculations via REST API. Used by 2,800+ developers building astrology apps, horoscope features, and compatibility tools.

## Key Information

- API Base: https://api.astrology-api.io/v3/
- Documentation: https://api.astrology-api.io/rapidoc
- OpenAPI Specs:
  - Full API: https://api.astrology-api.io/api/v3/openapi.json
  - Basic: https://api.astrology-api.io/openapi/basic.json
  - Western: https://api.astrology-api.io/openapi/western.json
  - Vedic/Jyotish: https://api.astrology-api.io/openapi/vedic.json
  - Astrocartography: https://api.astrology-api.io/openapi/astrocartography.json
  - Horary: https://api.astrology-api.io/openapi/horary.json
  - Human Design: https://api.astrology-api.io/openapi/human-design.json
  - All namespaces: https://api.astrology-api.io/openapi/namespaces
- Pricing: Free tier (50 req/mo), Starter $11/mo, Pro $37/mo, Business $99/mo
- Response Time: ~300ms average
- Uptime SLA: 99.9%

## Core Products

### Birth Charts & Natal Analysis
- [Natal Chart API](/p/natal-api): Complete birth chart calculations with 100+ data points
- [Birth Chart API](/p/birth-chart-api): Planetary positions, houses, aspects
- [Chart SVG Generation](/p/chart-svg): Vector chart images for any birth data
- [House Systems](/p/house-systems): 23 house systems (Placidus, Koch, Whole Sign, etc.)

### Horoscopes & Daily Guidance
- [Horoscope API](/p/horoscope-api): AI-generated daily horoscopes
- [Daily Horoscope API](/p/daily-horoscope-api): Sun sign daily predictions
- [Weekly Horoscope](/p/horoscope-weekly): 7-day forecasts
- [Monthly Horoscope](/p/horoscope-monthly): Month-ahead guidance
- [Personalized Horoscopes](/p/personalized-horoscopes-api): Birth chart-based predictions

### Compatibility & Relationships
- [Synastry API](/p/synastry-api): Relationship compatibility analysis
- [Compatibility API](/p/compatibility-api): Partner matching scores
- [Composite Chart API](/p/composite-api): Relationship chart calculations

### Transits & Predictions
- [Transit API](/p/transit-api): Current planetary influences
- [Predictive API](/p/predictive-api): Future transit predictions
- [Secondary Progressions](/p/secondary-progressions): Progressed chart calculations
- [Solar Return](/p/solar-return): Birthday year forecasts
- [Lunar Return](/p/lunar-return): Monthly cycle analysis
- [Profections](/p/profections): Annual profection calculations

### Location-Based Astrology
- [Astrocartography](/p/astrocartography): Planetary lines on world map
- [Relocation API](/p/relocation-api): Best places to live analysis
- [Local Space](/p/local-space): Directional astrology

### Chinese Astrology
- [Chinese Zodiac API](/p/chinese-zodiac): Animal signs and elements
- [Chinese Horoscope](/p/chinese-horoscope): Traditional Chinese predictions
- [BaZi Calculator](/p/chinese-bazi): Four Pillars of Destiny
- [Flying Stars](/p/chinese-flying-stars): Feng Shui calculations

### Numerology
- [Numerology API](/p/numeroscope): Life path, destiny numbers
- [Name Numerology](/p/numerology-name): Name vibration analysis
- [Numerology Forecast](/p/numerology-forecast): Personal year predictions

### Tarot
- [Tarot API](/p/tarot-api): Digital tarot readings
- [Celtic Cross](/p/tarot-celtic): 10-card spread interpretations
- [Tarot Timing](/p/tarot-timing): Predictive timing with cards

### Advanced Calculations
- [Arabic Parts](/p/arabic-parts): 97+ lot calculations
- [Fixed Stars](/p/fixed-stars): Star conjunctions and meanings
- [Asteroids](/p/asteroids): Chiron, Ceres, Pallas, Juno, Vesta
- [Midpoints](/p/midpoints): Planetary midpoint analysis
- [Harmonics](/p/harmonics): Harmonic chart calculations

### Business & Insights
- [Business Astrology](/p/business-astrology): Corporate timing
- [Career API](/p/career-api): Vocational guidance
- [Electional Astrology](/p/electional): Best timing for events
- [Trading Insights](/p/insights-trading): Financial astrology

## Technical Specifications

- **Precision**: Swiss Ephemeris (0.001 arc seconds)
- **House Systems**: 23 (Placidus, Koch, Whole Sign, Regiomontanus, Campanus, Equal, Porphyry, Morinus, Alcabitius, Axial, Horizon, Meridian, Azimuthal, Polich-Page, Krusinski, Carter, Gauquelin, Sunshine, Vedic, Sripati, Custom)
- **Languages**: 9 (English, Spanish, French, German, Italian, Portuguese, Russian, Chinese, Japanese)
- **Response Format**: JSON
- **Authentication**: Bearer Token (Authorization: Bearer YOUR_API_KEY)

## Getting Started

1. Get free API key: https://dashboard.astrology-api.io/
2. Make first request in <5 minutes
3. 50 free requests/month included

## Support

- Email: support@astrology-api.io
- Documentation: https://api.astrology-api.io/rapidoc
- Status: https://status.astrology-api.io