✋ Palmistry API and 🎧 Audio Reports API are now live. Ship them in your app today.
Astro Chat API

Personalized Astro Chat

Start a personalized conversation with an astrological assistant based on a single birth chart. This endpoint supports both Vedic and Western traditions with various expertise levels.
POSThttps://json-chat.astrologyapi.com/api/chat

Personalized Astro Chat Overview

Send a POST request to https://json-chat.astrologyapi.com/api/chat. Authenticate with your API access token. The request body accepts the following parameters:

ParameterTypeDescription
languagerequiredstringLanguage code (e.g., "en")
namerequiredstringName of the person
dayrequirednumberBirth day
monthrequirednumberBirth month
yearrequirednumberBirth year
hourrequirednumberBirth hour (24-hour format)
minrequirednumberBirth minute
placerequiredstringBirth city
latrequiredstringLatitude of birth place
lonrequiredstringLongitude of birth place
tzonerequiredstringTimezone offset (e.g., "5.5")
genderrequiredstringGender ("male" or "female")
countryrequiredstringCountry of birth
aprequiredstringAstro Profile. Set to "KUNDLI" for personalized chart chat.
sidrequiredstringUnique identifier for the current chat session. Use the same session ID and ap to continue an existing conversation. Start a new session to switch personas.
eprequiredstringExpertise level. Options: "STANDARD", "ADVANCED", "ULTRA_FAST" and "EXPERT".
acrequiredstringAstrological category. Options: "VEDIC", "WESTERN".
qrequiredstringThe astrological question or query.

API Details

Request

Example request body:

{
  "language": "en",
  "name": "David",
  "day": 1,
  "month": 11,
  "year": 2005,
  "hour": 19,
  "min": 45,
  "place": "Mumbai",
  "lat": "19.17",
  "lon": "73.7",
  "tzone": "5.5",
  "gender": "male",
  "country": "INDIA",
  "ap": "KUNDLI",
  "sid": "",
  "ep": "STANDARD",
  "ac": "VEDIC",
  "q": "hi"
}

Code samples

curl --location 'https://json-chat.astrologyapi.com/api/chat' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "language": "en",
    "name": "David",
    "day": 1,
    "month": 11,
    "year": 2005,
    "hour": 19,
    "min": 45,
    "place": "Mumbai",
    "lat": "19.17",
    "lon": "73.7",
    "tzone": "5.5",
    "gender": "male",
    "country": "INDIA",
    "ap": "KUNDLI",
    "sid": "",
    "ep": "STANDARD",
    "ac": "VEDIC",
    "q": "hi"
}'

Response

Example response:

{
  "success": true,
  "response": "Based on your birth details, your Sun is in Scorpio and Moon is in Libra. This indicates a deep, intuitive nature with a strong focus on balance and harmony...",
  "session_id": "5ec38d54-6f24-4efc-b8ba-30b36cdd6591",
  "message_id": 1,
  "query": "hi"
}

Related guides

The Chat API authenticates with a wallet access token — see Access tokens vs. User ID and API key for how tokens work and Pay as you go with a wallet for funding one. To build your own conversational layer on raw chart data instead, read Ground an LLM on computed charts.