Planet House Report API

The Planet House Report API generates a detailed life report based on the house position of a specific planet in a native's Vedic birth chart. In Jyotish astrology, the house a planet occupies is one of the most significant determinants of how that planet's energy manifests across different life domains — such as wealth, relationships, career, health, and spirituality. This API delivers a focused, planet-specific narrative that explains the real-world implications of that planet's placement in its natal house.

The API accepts a native's birth date, time, and geographic coordinates along with a planet identifier, calculates the planet's house position using the specified Ayanamsha, and returns a rich interpretive report tailored to that planet-house combination.

Supported planets are: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu and Ketu.

What data it returns

• A comprehensive narrative report describing the effects of the specified planet's placement in its natal house across all relevant life areas

• Insights into the planet's strength, dignity, and behavioural tendencies as influenced by its house position

• Life domain analysis covering areas such as personality, finances, relationships, profession, health, and spiritual inclinations, as shaped by the planet-house combination

• Positive traits, challenges, and karmic themes associated with the specific planet-house placement

• Guidance on how the planet's house position interacts with the native's overall life trajectory and key life events

• Localised interpretive content based on the requested language

Main use cases

• Personalised horoscope reports — Generating planet-specific house reports as individual sections within a comprehensive birth chart reading

• Life area deep-dives — Providing users with focused insights into how a particular planet shapes specific life domains based on its house placement

• Astrology apps and platforms — Powering "planet in house" features that deliver on-demand interpretive content for each of the nine supported planets

• Astrological counselling tools — Assisting practitioners in producing structured, data-driven planet-house narratives for client consultations

• Educational astrology content — Explaining the significance of planetary house placements to learners and enthusiasts in an accessible, personalised format

• Multi-planet report generation — Calling the endpoint iteratively for each planet to assemble a complete set of house-based life reports for a native

Key functionality

• Planet-specific house interpretation — Delivers tailored interpretive content for each of the eight supported planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu), with narratives specific to the planet-house combination rather than generic house descriptions

• Full house range coverage — Generates reports for any of the twelve houses, covering the complete spectrum of life domains governed by Vedic astrology's house system

• Configurable Ayanamsha — Supports multiple Ayanamsha settings (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, ensuring accurate planetary position calculations aligned with different Jyotish traditions

• Geographic precision — Uses latitude, longitude, and timezone inputs to compute precise local planetary positions for the native's birth location

• Multi-language support — Responses can be localised via the Accept-Language header, making the API suitable for regional and multilingual astrology platforms

• Modular report architecture — Designed to be called per planet, enabling flexible report assembly where individual planet-house reports can be combined, filtered, or presented independently within an application

• Suite integration — Works seamlessly alongside other life report and horoscope endpoints in the AstroInsight API suite for building complete, multi-dimensional astrological experiences