SEARCH ASTRO INSIGHT API DOCS

Extended Planets

Returns a rich, extended set of planetary position data for all nine Vedic grahas for a given date, time, and geographic location — providing a deeper and more attribute-complete planetary data set than the standard Planets endpoint, including additional classical Vedic attributes for each planet that support advanced chart analysis, interpretation, and report generation.

What this API does

The Extended Planets endpoint builds on the standard Planets endpoint by returning a significantly expanded set of attributes for each of the nine grahas. In addition to the core positional data — sidereal sign, degree, house, Nakshatra, Pada, and retrograde status — it provides a range of additional classical Vedic attributes for each planet, such as dignity status (exaltation, debilitation, own sign, friendly/enemy sign), speed, declination, combustion status, and other planet-specific qualities used in advanced Vedic analysis.

This endpoint is designed for applications and practitioners who require the full depth of planetary data for each graha in a single request — whether for rendering a detailed planetary positions table with dignity and combustion indicators, performing Shadbala or other strength calculations that require speed and declination data, or generating comprehensive horoscope reports that include per-planet qualitative assessments.

Like the standard Planets endpoint, it is applicable to both natal chart computation (using a birth date and time) and to current or future planetary position lookups, making it versatile for birth chart analysis, transit tracking, and ephemeris features.

What data it returns

The API returns a structured JSON response including, for each of the nine grahas (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu):

• Core positional data: Sidereal sign (Rashi), degree within the sign, absolute longitude, house placement relative to the computed Ascendant, Nakshatra, Pada, and retrograde status
• Dignity status: Whether the planet is in exaltation, debilitation, own sign, Moolatrikona, or a friendly/neutral/enemy sign — a key indicator of planetary strength and quality
• Combustion status: Whether the planet is combust (too close to the Sun to express its significations freely), which is a significant weakening factor in classical Vedic analysis
• Planetary speed: The daily motion of each planet at the specified date and time, used in speed-based strength calculations such as Chesta Bala
• Declination: The celestial declination of each planet, used in certain advanced Vedic and astronomical calculations
• Additional classical attributes: Further planet-specific qualities and positional details that support advanced interpretation, yoga detection, and strength assessment
• Ascendant (Lagna): The rising sign and degree computed from the provided coordinates, used as the reference point for house placements

Main use cases

• Advanced planetary positions table display in astrology applications that show not just sign, house, and Nakshatra but also dignity, combustion, and speed indicators for each planet — providing practitioners and users with a complete at-a-glance planetary quality assessment
• Shadbala and planetary strength calculations that require planetary speed (Chesta Bala), declination, and dignity status as inputs — this endpoint provides all the necessary raw data in a single call
• Combustion detection and reporting for horoscope reports and consultation tools that flag combust planets and explain their reduced ability to deliver results
• Dignity-based chart interpretation for features that assess whether planets are well-placed (exalted, own sign) or poorly placed (debilitated, enemy sign) and generate corresponding interpretive content
• Comprehensive horoscope report generation where each planet's extended attributes — dignity, combustion, speed, declination — are used to produce detailed per-planet analysis sections
• Transit tracking with quality indicators where the extended attributes of transiting planets (particularly dignity and combustion status) are used to assess the quality of transits beyond simple sign and house placement
• Yoga detection pipelines that use dignity status, house placement, and mutual relationships between planets to identify classical Vedic yogas such as Raja Yoga, Dhana Yoga, or Neecha Bhanga Raja Yoga
• Astrology research and education platforms that require the full depth of planetary attribute data for comparative analysis, ayanamsha studies, or teaching advanced chart interpretation techniques

Key functionality

• Extended attribute set per planet: Returns significantly more data per graha than the standard Planets endpoint — including dignity status, combustion status, speed, and declination — providing everything needed for advanced planetary analysis in a single response.
• Dignity and combustion indicators: Delivers classical Vedic dignity assessments (exaltation, debilitation, own sign, Moolatrikona, friendly/enemy) and combustion flags for all applicable planets, enabling immediate qualitative assessment of each planet's strength and condition.
• Planetary speed data: Returns the daily motion of each planet, directly usable as input for Chesta Bala (motional strength) calculations in Shadbala and other classical strength systems.
• All nine grahas in one request: Covers all seven classical planets plus Rahu and Ketu, delivering the complete Vedic graha set with extended attributes in a single API call.
• Dual use for natal and transit analysis: Accepts any date and time, making the endpoint equally applicable to birth chart computation and to current, past, or future planetary position lookups for transit and ephemeris use cases.
• Ascendant and house placement included: Computes the Ascendant from the provided coordinates and returns each planet's house placement relative to it, enabling house-based analysis without a separate chart structure request.
• Ayanamsha selection: The X-Ayanamsha header allows selection of the sidereal calculation system (e.g., Lahiri, Raman, KP), ensuring all planetary positions and derived attributes are computed according to the practitioner's or platform's preferred Vedic tradition.
• Geographic coordinate support: Uses latitude and longitude for precise Ascendant and house cusp calculation, ensuring accuracy for birth locations and query locations anywhere in the world.
• Multilingual support: The Accept-Language header enables localized planet names, sign names, Nakshatra names, and dignity descriptions, making the API suitable for a global, multilingual user base.