Astro ChatBot API
Introducing the Astro ChatBot API, a simple and reliable way to let users ask any astrology question in plain language and get one grounded, chart-based answer back. You send a question and the person's birth details; DivineAPI fetches and compresses their chart, and streams back an answer written for a reader, not a developer. This API is designed for websites, mobile apps, chatbots, CRM dashboards, or astrology portals that want a conversational astrology experience instead of static reports.
It supports seven endpoints: one to ask a question inside a stored conversation, four to manage and inspect those conversations and your account, and one liveness check.
API Endpoint
GET https://ask.divineapi.com/usageGuide: Usage broken down by day, for reconciling your own billing. Takes api_key as a query parameter.
200: OK Answered Successfully
{
"totals": {
"requests": 529, "cost_inr": 61.4, "in_tok": 2540120, "out_tok": 105830,
"cache_read_tok": 1270060, "blocked": 0, "avg_ms": 3210
},
"by_band": [
{ "band": "standard", "requests": 401, "avg_cost_inr": 0.11,
"avg_charged_inr": 0.9, "margin_pct": 88 }
],
"grounding": [
{ "code_check": "ok", "ai_judge": "ok", "count": 520 }
]
}Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl "https://ask.divineapi.com/usage?api_key=dk_live_..."