Horoscope Widget API

The AstroAPI Horoscope Widget is a lightweight, embeddable astrology chart component designed for modern web platforms. It renders professional-grade astrology charts directly in the browser, powered by AstroAPI’s backend calculation engine.

The widget can be embedded on any website with a single script tag, without collecting personal data, requesting browser permissions, or exposing private credentials.

Astrological Tradition

The AstroAPI Horoscope Widget is built for Western astrology and follows a tropical, geocentric chart model using whole-sign houses. Chart calculations are performed from an Earth-centered perspective, consistent with traditional Hellenistic astrology.

Planetary positions are measured using the tropical zodiac, and houses are assigned by sign rather than degree divisions. Aspect relationships follow classical planet-based aspect theory used by professional astrologers.

This approach supports traditional Hellenistic techniques while remaining compatible with modern Western astrology workflows, maintaining interpretive rigor and technical transparency.

What the Horoscope Widget Supports

  • Single-wheel and bi-wheel chart modes
  • Manual transit navigation forward and backward in time
  • User-entered location and date inputs
  • SVG-based chart rendering
  • No frameworks or third-party UI dependencies
  • Server-side astrology calculations via AstroAPI

The widget shown above is fully interactive. Users can manually enter a location and date to generate astrology charts without any automatic location detection or tracking.

Embedding the Horoscope Widget

The snippet below demonstrates how the Horoscope Widget is embedded. This example is safe to include in public documentation and does not request browser permissions or expose API keys. 

<script
  type="module"
  src="https://astroapi.io/js/widget/embed.js"
  data-view="wheel"
  data-theme="dark">
</script>

When deployed in production environments, AstroAPI applies rate limiting and usage controls on the backend. All user input is entered explicitly by the site visitor.