Getting Started

AstroAPI provides a comprehensive set of endpoints for astrology calculations, chart generation, and interpretations.

Base URL

https://api.astroapi.cloud

Authentication

API Key Authentication

Include your API key in the X-Api-Key header:

curl -X GET "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key"

Quick Example

Calculate a natal chart:

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Response Format

All responses follow the JSON:API specification with application/vnd.api+json content type.

Next Steps

• Authentication - Learn about API keys and permissions
• Rate Limits - Understand usage limits
• API Reference - Explore all available endpoints