✨ Audio Horoscope
RFC 8288 & RFC 9727 Discoverable API

Developer & Agent API Documentation

Audio Horoscope exposes high-precision astrological ephemeris calculations, natal chart placements, synastry algorithms, and audio generation endpoints for autonomous AI agents and developer integrations.

Agent Discovery Metadata (RFC 8288 / RFC 9727)

All homepage and HTML responses return standardized HTTP Link headers advertising our machine-readable specifications:

Link: </.well-known/api-catalog>; rel="api-catalog", </.well-known/openapi.json>; rel="service-desc"; type="application/openapi+json", </docs/api>; rel="service-doc", </llms.txt>; rel="describedby"; type="text/markdown", </llms.txt>; rel="alternate"; type="text/markdown", </sitemap.xml>; rel="sitemap"
GET /health

System health check, uptime, and availability.

curl -s https://audiohoroscope.xyz/health
POST /api/astrology/natal-chart

Computes planetary degrees, house placements, and rising sign using Precision Ephemeris (0.00° variance).

curl -X POST https://audiohoroscope.xyz/api/astrology/natal-chart \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"latitude":40.7128,"longitude":-74.006}'
POST /api/astrology/synastry

Calculates dual-chart synastry, aspect harmonics, and emotional resonance scores.

curl -X POST https://audiohoroscope.xyz/api/astrology/synastry \
  -H "Content-Type: application/json" \
  -d '{"person1":{...},"person2":{...}}'
GET /api/audio/daily-preview

Retrieves daily personalized spoken audio horoscope preview and astrological commentary.

curl -s https://audiohoroscope.xyz/api/audio/daily-preview
GET /api/blog/posts

Retrieves published astrology blog articles, transit forecasts, and audio narrations.

curl -s https://audiohoroscope.xyz/api/blog/posts