SEARCH ASTRO INSIGHT API DOCS
The Planet House Report API generates detailed interpretations of how a selected planet influences a specific house in a birth chart. It is ideal for horoscope reports and personalized astrology insights.
https://json.astroinsightapi.com/api/v1/life-report/house/:planetKey
en
hi
Methodology and astrological context for Planet House Report.
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
Payload specifications for JSON request body.
| Parameter | Type | Description & Example |
|---|---|---|
|
day
Required
|
integer |
Day of birth (1–31).
Example:
15
|
|
month
Required
|
integer |
Month of birth (1–12).
Example:
9
|
|
year
Required
|
integer |
Year of birth (e.g., 1994).
Example:
1994
|
|
hour
Required
|
integer |
Hour of birth in 24-hour format (0–23).
Example:
12
|
|
min
Required
|
integer |
Minute of birth (0–59).
Example:
30
|
|
sec
Optional
|
integer |
Second of birth (0–59). Optional. If not provided, it is considered as 0.
Example:
30
|
|
lat
Required
|
float |
Latitude of the birth location.
Example:
28.6139
|
|
lon
Required
|
float |
Longitude of the birth location.
Example:
77.1025
|
|
tzone
Optional
|
float |
Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example:
5.5
|
| Header Key | Value / Format | Description |
|---|---|---|
|
Authorization
Required
|
Basic {base64} |
Base64 encoded string of CLIENT_ID:CLIENT_SECRET. |
|
Content-Type
Required
|
application/json |
Specifies JSON payload format in request body. |
|
Accept-Language
Optional
|
en, hi, ta, te... |
Returns localized astrology output. Default: en |
|
X-Ayanamsha
Optional
|
lahiri, raman, krishnamurti... |
Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri |
Explore complementary endpoints in this category.
Comprehensive developer guidance for Planet House Report.
The Planet House Report API provides authentic Life Report calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.
The Planet House Report API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.
Each calculation request to Planet House Report consumes 1 API credit. The endpoint delivers high performance with an average response time of ~80ms.
Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).
Yes! The API supports multiple languages including English, Hindi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.
Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.
The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.