Developer Platform · v1.3.0

The Astrocartography
Calculation Engine

Production-ready astrocartography REST API powered by Swiss Ephemeris. Returns planetary line GeoJSON vectors, city compatibility scores, and transit-based timing intelligence for any birth chart.

Interactive Playground Full Documentation
As featured in National Geographic & Vogue

API Reference

Endpoints

POST

/v1/calculate-lines

Core astrocartography endpoint. Returns MC/IC longitude lines and curved ASC/DSC coordinate arrays for all major planets.

GeoJSON Compatible Swiss Ephemeris ~120ms
POST

/v1/score-city

Intelligent city scoring. Returns 0-100 compatibility score with category breakdowns (love/work/travel/growth/health) and natural language insights.

Category Scoring Natural Language ~150ms
NEW
POST

/v1/score-city-timing

Transit-based timing intelligence. Scores cities for specific travel dates by combining birth chart + current transits. Returns best days to visit with active transit analysis.

Transit Analysis Best Days Date-Specific ~1-3s
View Complete API Reference

Quick Start

Example: Transit Timing
bash — cURL 
curl -X POST "https://api.maphrodite.com/v1/score-city-timing" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -d '{
    "date": "1990-05-20",
    "time": "14:30",
    "lat": 51.5074,
    "lon": -0.1278,
    "city_lat": 48.8566,
    "city_lon": 2.3522,
    "city_name": "Paris",
    "visit_start": "2026-06-01",
    "visit_end": "2026-06-07",
    "mode": "travel"
  }'

Technical Specifications

Built for Scale

⚡️

Swiss Ephemeris

Sub-arcsecond precision (0.001") using the same astronomical data source as NASA's JPL HORIZONS system.

  • ±13,000 year date range
  • Sun through Pluto (10 bodies)
🔒

Zero PII Storage

Fully stateless architecture. All calculations are processed in memory and immediately discarded — no personal data is ever written to disk.

  • No database persistence
  • GDPR & CCPA compliant
🎯

Transit Intelligence

Dynamic timing analysis combines birth chart with real-time transits. Answer "When should I visit?" not just "Where should I go?"

  • Best days finder
  • Mode-specific weighting
~120ms
Avg Response Time
99.97%
Uptime SLA
0.001"
Calculation Precision
24/7
Support
Enterprise Access

Built for Serious Integrations

The Maphrodite Engine is used by travel platforms, consumer astrology apps, and location intelligence services worldwide. We work directly with teams to ensure the integration fits your architecture and scale.

Tell us about your use case — volume requirements, tech stack, and what you're building. We'll put together a proposal that fits.

Request Access Try the Playground First

api@maphrodite.com