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:

Parameter	Type	Description
languagerequired	string	Language code (e.g., "en")
namerequired	string	Name of the person
dayrequired	number	Birth day
monthrequired	number	Birth month
yearrequired	number	Birth year
hourrequired	number	Birth hour (24-hour format)
minrequired	number	Birth minute
placerequired	string	Birth city
latrequired	string	Latitude of birth place
lonrequired	string	Longitude of birth place
tzonerequired	string	Timezone offset (e.g., "5.5")
genderrequired	string	Gender ("male" or "female")
countryrequired	string	Country of birth
aprequired	string	Astro Profile. Options: "KUNDLI". For personalized chat, use "KUNDLI".
sidrequired	string	Unique identifier for the current chat session. Use the same session ID to continue an existing conversation.
eprequired	string	Expertise level. Options: "STANDARD", "ADVANCED", "EXPERT".
acrequired	string	Astrological category. Options: "VEDIC", "WESTERN".
qrequired	string	The 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:

{
  "status": true,
  "message": "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...",
  "response": {
    "sid": "astro-6",
    "timestamp": "2026-01-28T12:00:00Z"
  }
}