Try Astrologer API

Subscribe to support and grow the project.

v5 Astrologer API Documentation
Get API Key

Examples Endpoints

API Examples

Complete request and response examples for every Astrologer API v5 endpoint. Organized by category with chart previews.

Compatibility Score JSON Example

Example response for the Compatibility Score endpoint. Shows numerical scores, qualitative descriptions, and inter-aspect data for synastry.

Composite Chart JSON Data Example

JSON example for Composite Chart data. Structure of midpoint calculations representing the unique essence of a partnership.

Composite Chart SVG Example

See a sample SVG composite chart. Visual representation of the relationship as a single entity based on planetary midpoints between partners.

Composite Context JSON Example

Sample composite chart context in JSON format. Provides the structural entity context required for AI-powered relationship destiny insights.

Lunar Return Chart SVG Example

SVG example for the Lunar Return Chart. Visual representation of the monthly emotional cycle based on the Moons return to its natal degree.

Lunar Return Context JSON Example

Sample JSON response for Lunar Return context optimized for AI cycles. Provides structured emotional themes for LLM monthly outlooks.

Lunar Return JSON Data Example

JSON example for Lunar Return data. Shows the calculated positions for the natal subject and the return moment for monthly forecasting.

Moon Phase Context JSON Example

Complete JSON example of moon phase data with AI-optimized XML context for LLM integration.

Moon Phase JSON Example

Complete JSON example of detailed moon phase data including illumination, upcoming phases, eclipses, and sun position.

Moon Phase Now (UTC) JSON Example

JSON example of real-time moon phase data at Greenwich Observatory. Shows the response structure for the current lunar state.

Moon Phase Now Context (UTC) JSON Example

Complete JSON example of current moon phase data with AI-optimized XML context at Greenwich.

Natal Chart JSON Data Example

Example JSON response for full natal calculations. Structure of machine-readable data for planets, houses, and aspects in a birth chart.

Natal Chart SVG Example

Sample SVG output for a professional birth chart. High-quality visualization of natal planetary placements, houses, and aspect patterns.

Natal Context JSON Example

Complete JSON example for AI-ready natal chart context. Demonstrates how chart dynamics are summarized for Large Language Models (LLMs).

Now Chart SVG Example

View a sample Now chart SVG. Real-time visualization of the current global planetary positions rendered as a professional chart wheel.

Now Context JSON Example

Example JSON response providing real-time astrological context for AI models. Optimized for Current Sky or Vibe Check interpretations.

Now Subject JSON Example

Example JSON output for real-time subject data. Demonstrates the structure of astrological data calculated for the current moment.

Solar Return Chart SVG Example

Sample SVG output for a Solar Return. Professional dual-wheel visualization for annual birthday forecasting and year-ahead planning.

Solar Return Context JSON Example

Formatted JSON example of Solar Return context for AI forecasting. Provides the thematic summaries for LLM predictive readings.

Solar Return JSON Data Example

JSON example for Solar Return data. Structure of calculations for the exact moment of the annual solar return for predictive astrology.

Subject Context JSON Example

Sample JSON output showing structured astrological context for AI personality insights. Formatted for use as a baseline for LLM-generated readings.

Subject JSON Data Example

JSON example of a calculated astrological subject. Shows the result of raw birth data processed through high-precision ephemeris engines.

Synastry Chart JSON Data Example

Example JSON response for relationship compatibility calculations. Highlights inter-axial and inter-planetary aspects between two subjects.

Synastry Chart SVG Example

View a sample SVG output for the Synastry Chart endpoint. Professional dual-wheel visualization of relationship compatibility and inter-aspects.

Synastry Context JSON Example

JSON example of relationship context optimized for AI interpretation. Shows synthesized synastry data ready for LLM processing.

Transit Chart JSON Data Example

Example JSON response for Transit Chart Data. Highlights the structure of transit-to-natal aspect calculations and planetary positions.

Transit Chart SVG Example

SVG example for the Transit Chart endpoint. Professional dual-wheel visualization comparing current planetary movements to a natal foundation.

Transit Context JSON Example

Example JSON output for transit context designed for AI narratives. Highlights how current planetary influences are summarized for LLM analysis.

Build With Astrology Data

Natal charts, synastry, transits & AI interpretations — all via REST API.

Try Astrologer API