Use case
Remedy API for puja and spiritual stores
Updated
How it works
- 1An online store sells puja kits, gemstones and other spiritual goods.
- 2The API gives the date and the best puja time for a festival like Diwali in the customer's city. So the store offers the right kit at the right time.
- 3From the customer's own chart, the API suggests a gemstone and the planet it is for, so the store can explain every suggestion.
POST /v1/reading/section/topic:remedy-life-gemstone?as_of=2026-10-01200 OK{
"section": {
"id": "topic:remedy-life-gemstone"
},
"blocks": [
{
"selection": {
"graha": "Mercury",
"stone": "Emerald",
"metal": "gold",
"finger": "little",
"day": "Wednesday"
}
}
]
}How to add chart-based remedies to your store
Each step is one call, linked to its page in the API reference. Where a card shows values, they are real API output. Planet positions come from NASA JPL planet data (DE440). We check them against NASA JPL Horizons. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. An arc second is 1/3,600 of a degree. See how we test accuracy. A practicing astrologer reviews the rules behind these answers. Each rule has an ID in the public rulebook.
- 01
Find the doshas
POST /v1/dosha/allManglik, kaal sarp and pitra dosha, each with a plain answer, before you suggest anything.
- doshas.manglik.present
- true
- doshas.kaalsarpa.present
- false
- doshas.pitra.present
- true
Real output for John Doe, born Aug 15, 1990, 10:30 AM, New York.
- 02
Suggest remedies
POST /v1/reading/section/{section_id}Gemstone, rudraksha, mantra and havan (fire ritual) suggestions, each tied to a planet. Ask for one section at a time, such as topic:remedy-havan-puja or topic:remedy-rudraksha.
- section.id
- "topic:remedy-life-gemstone"
- blocks.0.selection.graha
- "Mercury"
- blocks.0.selection.stone
- "Emerald"
Real output for John Doe, born Aug 15, 1990, 10:30 AM, New York.
- 03
Pick a good time
GET /v1/panchang/dailyGood times and rahu kaal (a daily time to avoid) for the puja date, in the customer's city.
- auspicious.abhijit_muhurta.starts
- "2026-10-01T12:21:46-04:00"
- auspicious.abhijit_muhurta.ends
- "2026-10-01T13:08:47-04:00"
- inauspicious.rahu_kaal.starts
- "2026-10-01T14:13:27-04:00"
Real output from the example in the API reference.
- 04
Plan around festivals
GET /v1/festivalsFestival dates for the customer's city, for seasonal pujas and offers.
- year
- 2026
- festivals.1.name
- "Ganesh Jayanti"
- festivals.1.date
- "2026-01-22"
Real output from the example in the API reference.
What you send, what you get, what it costs
| You send | The customer's birth date, time and place. The panchang and festival calls need only a date and a city. |
|---|---|
| You get | The doshas in the chart, gemstone, rudraksha, mantra and havan suggestions tied to a planet, good times for the puja and festival dates. |
| It costs | Steps 1, 3 and 4: 1 call each.Step 2: 1 reading credit a chapter (3 for the year ahead). |
Costs are for a live key, and failed requests are free. The Free plan includes 2,000 calls and 150 reading credits a month.
Step 1 in code: find the doshas
Send the details as JSON, with your API key in the Authorization header. The other steps work the same way, and each one links to its page in the API reference.
POST /v1/dosha/all
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/dosha/all" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'Tips for going live
- Map each remedy section id to a catalog tag, such as topic:remedy-rudraksha to your rudraksha products.
- Show the planet next to each suggestion, so the customer can see why a rudraksha or a mantra was picked for them.
- Times depend on the place: rahu kaal in New York is not rahu kaal in Los Angeles, so ask for each city.
- Treat birth details as personal data, and say in your privacy notice what you use them for.
What it costs
A puja store that checks 500 customers a month for doshas and shows each one two remedy suggestions uses 500 calls and 1,000 reading credits. Starter.
Every plan can call every endpoint: calls for calculations, reading credits for written readings. Test keys are free on every plan, with 1,000 calls a month. Paid plans start at $29 a month, and failed requests are free.
See pricingTry it free
See an answer first
Today's panchang
Tithi (lunar day), nakshatra, sunrise, rahu kaal and the choghadiya (good and bad parts of the day) for your own city.
See today's panchang
Features used here
Read next
From the blog
· 8 min read
Kundli and Panchang for Puja Stores and Temple Websites
Four features that bring visitors back to a puja store or temple site, the API call behind each…
Read
· 8 min read
Why Hindu Festival Dates Change by City: Karva Chauth 2026
Karva Chauth 2026 is October 28 in New York but October 29 in Delhi.
Read
Common questions
All questionsCan the API pick a muhurat for a puja?
Not as its own activity. POST /v1/muhurta/{activity} finds good times for buying a vehicle, buying property, moving into a new home, marriage and starting a business. For a puja date, use GET /v1/panchang/daily for the customer's city. It gives abhijit muhurat, a good time around noon, and the times to avoid, such as rahu kaal. It also gives the choghadiya and hora periods, slices of the day used to pick a time.
About the panchang APIHow do we link a suggested remedy to products in our catalog?
Read the selection object, not the reading text. It holds plain fields, such as the planet and the mukhi (number of faces) for a rudraksha. For a gemstone, it holds the planet and the stone. Tag your products with the same values, and a change of wording in the text never breaks the link.
About the remedies APIWhy do a customer's suggestions change over time?
Most remedy sections, including the rudraksha, mantra and havan, follow the planet whose main period (mahadasha) is running on the as_of date. When that period ends, often after many years, the suggestions move to the next planet. Send the order date as as_of so the suggestion fits the day the customer buys.
What a mahadasha isCan a puja store offer a dosha puja only to customers whose chart has the dosha?
Yes. The kaal sarp, pitra dosha and sade sati (a long Saturn period) remedy sections exist only when the chart has that condition. POST /v1/reading/sections lists the section ids a chart has. Asking for one it does not have returns 404. So your store never offers a puja for a dosha the customer does not have.
About the dosha APICan we plan seasonal offers around festivals and fasting days?
Yes. GET /v1/festivals gives festival dates for any year and city, and GET /v1/vrats gives every Ekadashi, Pradosh, Sankashti Chaturthi, Masik Shivaratri, Purnima and Amavasya. A date can fall a day apart in two cities, so fetch the calendar for each region you sell to.
About the Hindu calendar APICan our store say a remedy will work?
Our terms describe gemstones, mantras and pujas as traditional practices, and we make no claim that they work. API output must not be shown as medical, legal, financial or psychological advice. You are responsible for the claims your store makes.
Read the astrology disclaimerAstrology API
Start with a free test key
Create an account and a test key, then try each step above. Need more than the largest plan? Write to us.
Your first answer
John Doe, New York
- RisingVirgoHast
- SunCancerAshlesha
- MoonTaurusMrigashira
- MarsAriesKrittika
Real API output. A free test key gets the same answer.
01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
Open rules: every rule is published, so you can check any answer