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": 7,
"credits_charged": 230,
"in_tok": 58872,
"out_tok": 838,
"cache_read_tok": 0,
"blocked": 0,
"avg_ms": 4976
},
"per_customer": [
{
"api_key": "dk_live_....",
"requests": 7,
"credits_charged": 230,
"blocked": 0
}
],
"by_band": [
{
"band": "simple",
"requests": 2,
"credits_charged": 40
},
{
"band": "standard",
"requests": 3,
"credits_charged": 90
},
{
"band": "deep",
"requests": 2,
"credits_charged": 100
}
],
"by_model": [
{
"model": "gpt-5.6-luna",
"requests": 7
}
],
"blocks": [],
"grounding": [
{
"code_check": "ok",
"ai_judge": "ok",
"count": 5
},
{
"code_check": "ok",
"ai_judge": "pending",
"count": 2
}
],
"content_logging": true
}Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl "https://ask.divineapi.com/usage?api_key=dk_live_..."