SEARCH ASTRO INSIGHT API DOCS
The Detailed Yantra Suggestions API provides Suggestions related calculations and insights based on Vedic Astrology principles. This endpoint is designed for astrology applications, report generation systems, horoscope platforms, and developer integrations requiring structured JSON responses and reliable REST API access.
https://json.astroinsightapi.com/api/v1/suggestions/yantra/detailed
en
hi
ma
Methodology and astrological context for Detailed Yantra Suggestions.
Returns a comprehensive, astrology-based Yantra recommendation report personalized to an individual's birth chart. This endpoint performs a full Vedic astrological analysis of the provided birth data and produces an in-depth profile for each recommended Yantra, making it suitable for practitioner reports, detailed client consultations, and feature-rich astrology applications.
This endpoint accepts a date, time, and geographic coordinates of birth, computes the individual's planetary positions using the specified Ayanamsha system, and maps those positions to their corresponding Yantras in the Vedic tradition. A Yantra is a sacred geometric diagram associated with a specific planet or deity, used as a tool for meditation, spiritual protection, energetic balancing, and planetary remediation. Unlike the basic endpoint, this endpoint returns a full remedial profile for each Yantra — including its deeper astrological context, ritual instructions, placement guidance, and activation procedures.
The response includes, for each recommended Yantra:
Yantra identity — name, associated planet or deity, and the ruling house in the birth chart
Astrological rationale — a detailed explanation of why this Yantra is recommended, based on the individual's planetary strengths, weaknesses, and house lordships
Remedial purpose — the specific life areas (e.g., career, health, relationships, spiritual growth) the Yantra is intended to support or correct
Activation instructions — the recommended day, time, mantra, and ritual procedure for energizing the Yantra
Placement guidance — where in the home or workspace the Yantra should be placed for maximum efficacy
Material and form — recommended material (e.g., copper, gold, silver, paper) and size considerations
Contraindications — planetary configurations or chart conditions under which the Yantra should be used with caution or avoided
Recommendation strength — an indication of how strongly the Yantra is indicated based on the full chart analysis
Jyotish practitioners — generating complete, client-ready Yantra remediation reports without manual chart analysis
Astrology platforms and apps — powering in-depth Yantra recommendation features for users seeking detailed spiritual guidance
Spiritual and wellness services — providing personalized Yantra prescriptions as part of holistic wellness or life coaching offerings
Vedic ritual and puja services — identifying and sourcing the correct Yantras for a client's specific astrological needs
Educational astrology tools — demonstrating the relationship between planetary positions and traditional Vedic remedies
Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, ensuring compatibility with different Vedic astrology schools and practitioner preferences
Accepts precise birth time and location (latitude, longitude, timezone) for accurate planetary degree and house calculations
Returns planet-specific astrological reasoning for each recommendation, making the output suitable for direct use in client-facing reports and consultations
Includes ritual and activation detail that goes beyond identification — giving practitioners and users actionable guidance on how to use each Yantra
Designed for localization — the Accept-Language header controls the language of all descriptive content in the response
Complements the Basic Yantra Suggestions endpoint: use the basic endpoint for lightweight lookups and this endpoint when a full remedial report with complete guidance is required
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 Detailed Yantra Suggestions.
The Detailed Yantra Suggestions API provides authentic Suggestions 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 Detailed Yantra Suggestions 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 Detailed Yantra Suggestions consumes 1 API credit. The endpoint delivers high performance with an average response time of ~74ms.
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, Marathi. 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.