Readings
Astrology Reading and Report API
Our astrology reading API turns a birth chart into text your users can read. It answers life questions such as career, marriage and money in plain English, writes a short summary with no astrology terms at all, and builds a full printable report. Every sentence comes from fixed rules, not an AI model.
POST /v1/reading/section/topic:personality?as_of=2026-10-01200 OK{
"section": {
"id": "topic:personality"
},
"blocks": [
{
"answer": {
"headline": "You tend to have a clear sense of who you are, and people often notice it. Your energy and confidence usually come easily, and you recover well when life gets hard."
}
}
]
}What the astrology reading API returns
- Readings on 27 topics, such as personality, career, love and marriage, wealth, education, sade sati and remedies. The life topics start with a plain answer.
- A summary of the whole chart, about two to three printed pages, with no planet names, signs or Sanskrit. Each part says what it is based on.
- A love, career or wealth forecast over a date range, with the periods and transits that matter and a reading for each.
- A printable report: one self-contained HTML page with every section, ready to print to PDF, with no outside files.
- Readings by section: the rising sign, the Moon sign, each planet, each house, the yogas and the doshas.
- Daily horoscopes, for a Moon sign or for one chart, have their own page: see the horoscope API below.
The same birth details always get the same words, because the text comes from a fixed library, not an AI model. Where no text is written yet for a combination, the response lists it as a gap instead of filling it with vague words. Send detail=expanded for longer text.
Endpoints
POST /v1/reading/sectionsList of reading sections for a chartPOST /v1/reading/section/{section_id}One section of a readingPOST /v1/reading/rulesChart rules from the built-in text, rankedPOST /v1/forecast/{theme}Love, career or wealth forecastPOST /v1/summaryPlain-language summary of a chartPOST /v1/reportFull reading as a printable HTML page
The rules behind it
A life topic is read from the houses, their rulers and the karakas (LP-01), and it is built from the chart, not stored as one paragraph (LP-03). When two rules in a chart point opposite ways, the reading names the disagreement and never averages it (RC-01). Nothing is weighted in secret: each reading states its rule (RD-02). Retrograde planets are reported but never counted (RD-04). Monthly readings are keyed on the transits (MF-01).
Browse the full rulebook27 topic readings
Life Prediction (6)
- Personality
topic:personality - Professional life
topic:professional-life - Love life and marriage
topic:love-and-marriage - Wealth
topic:wealth - Education
topic:education - Favorable and unfavorable periods
topic:favourable-periods
Monthly Forecast (6)
- Career
topic:monthly-career - Love life
topic:monthly-love - Wealth
topic:monthly-wealth - Favorable and unfavorable days
topic:monthly-days - Tips for the month
topic:monthly-tips - Transits this month
topic:monthly-transits
Sade Sati (6)
- Predictions
topic:sadesati-predictions - What to expect
topic:sadesati-expect - Rising period
topic:sadesati-rising - Peak period
topic:sadesati-peak - Setting period
topic:sadesati-setting - Remedies
topic:sadesati-remedies
Remedies (9)
- Life gemstone
topic:remedy-life-gemstone - Lucky gemstone
topic:remedy-lucky-gemstone - Rudraksha
topic:remedy-rudraksha - Lucky mantra
topic:remedy-lucky-mantra - Havan and puja
topic:remedy-havan-puja - General remedies
topic:remedy-general - Sade sati remedies
topic:remedy-sadesati - Kaal sarp remedies
topic:remedy-kaal-sarp - Pitra dosha remedies
topic:remedy-pitra-dosha
The printable report
The report opens with a short summary in plain words, then these chapters:
- Your signature
- Your birth details
- The chart
- Your periods
- The grahas
- The houses
- Where your chart disagrees with itself
- What the chart forms
- What is moving now (when you send a date (as_of))
- The topic readings (when you ask for them (topics=true))
“Where your chart disagrees with itself” shows where the chart's rules point in opposite directions. Read a full sample report.
Terms used here
Who uses it
- Astrology appsCharts, dashas, daily readings and a printable report from one API, so a small team can ship a full astrology app.
- Publishers and mediaDaily panchang, Moon-sign horoscopes, festival dates and sky events for any city, ready to publish every day.
- Puja and spiritual storesGemstone, rudraksha and puja suggestions tied to each customer's chart, with the reason for every one.
- AI assistants and chatbotsReal charts and plain answers for AI assistants and chatbots, so the model quotes a computed result instead of inventing one.
Astrology API
Call it with a free test key
Create an account and a test key, then call any endpoint on this page. Or try a request in the API reference first.
01
A free test key, with 1,000 requests a month
02
Try any endpoint in your browser first
03
Every rule published, so you can check any answer