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

Creativity Chat

A Vedic specialist for Creativity. Covers: Creative medium, blocks, creativity as income. Set ap to "CREATIVITY" for focused answers with chart evidence and a date window.
POSThttps://json-chat.astrologyapi.com/api/chat

Creativity 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:

Persona rules

  • Vedic only. Send ac: "VEDIC" or leave ac out. WESTERN returns 400 for specialist personas.
  • Partner chart. pd.partner is used by LOVE and MARRIAGE only.
  • One persona per session. Keep the same ap for a sid. Start a new session to switch personas. Off-topic questions get a redirect to the right persona.
  • Gender is strongly recommended. Include gender in pd. It changes marriage and matching readings.
ParameterTypeDescription
qrequiredstringThe astrological question or query.
aprequiredstringSet to "CREATIVITY". Keep this value for every message in the same sid.
pdrequiredobjectBirth profile with name, language, birth date, time, coordinates, timezone and place. gender is strongly recommended, especially for marriage and matching. pd.partner is used by LOVE and MARRIAGE only.
acstringUse "VEDIC" or omit. "WESTERN" returns 400 for specialist personas.
sidstringUnique 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.

API Details

Request

Example request body:

{
  "q": "Which creative medium suits me, and what might be blocking my creativity?",
  "ap": "CREATIVITY",
  "pd": {
    "name": "Sita Devi",
    "gender": "female",
    "language": "en",
    "day": 15,
    "month": 8,
    "year": 1990,
    "hour": 10,
    "min": 30,
    "lat": 28.6139,
    "lon": 77.209,
    "tzone": 5.5,
    "place": "New Delhi"
  },
  "ac": "VEDIC",
  "sid": ""
}

Code samples

curl --location 'https://json-chat.astrologyapi.com/api/chat' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "q": "Which creative medium suits me, and what might be blocking my creativity?",
    "ap": "CREATIVITY",
    "pd": {
        "name": "Sita Devi",
        "gender": "female",
        "language": "en",
        "day": 15,
        "month": 8,
        "year": 1990,
        "hour": 10,
        "min": 30,
        "lat": 28.6139,
        "lon": 77.209,
        "tzone": 5.5,
        "place": "New Delhi"
    },
    "ac": "VEDIC",
    "sid": ""
}'

Response

Illustrative response shape (answer varies by chart):

{
  "success": true,
  "response": "[Creativity answer with chart evidence and a date window]",
  "session_id": "5ec38d54-6f24-4efc-b8ba-30b36cdd6591",
  "message_id": 1,
  "query": "Which creative medium suits me, and what might be blocking my creativity?"
}

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.