Developers

PuranGPT API

Ask the scriptural corpus from your own code and get back cited, source-grounded answers. The API is available on the Pro plan.

1. Get an API key

Open Settings → API and create a key. It looks like pgk_live_… and is shown only once, so copy it somewhere safe. You can revoke a key at any time.

2. Call the endpoint

Send a POST to /api/v1/chat with your key in the Authorization header.

curl https://purangpt.com/api/v1/chat \
  -H "Authorization: Bearer pgk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What does the Bhagavad Gita say about acting without attachment to results?",
    "mode": "research",
    "language": "en"
  }'

Request body

query

string (required)

Your question.

mode

"research" | "guide"

Default "research". "guide" answers in Guruji's voice.

language

"en" | "hi" | "ru"

Default "en".

top_k

number 1–25

How many source passages to retrieve. Default 10.

session_id

string

Optional — continues a prior conversation.

stream

boolean

Default false. true returns a raw SSE stream instead of JSON.

Response

By default you get a single JSON object with the assembled answer and its citations:

{
  "answer": "Krishna tells Arjuna that one has a right to action alone…",
  "citations": [
    {
      "text_name": "Bhagavad Gita",
      "reference": "2.47",
      "text": "You have a right to your duty, but never to the fruits of action.",
      "language": "sa"
    }
  ],
  "session_id": "api:…",
  "grounding_quality": "high"
}

Errors

401

Missing or invalid API key.

403

The key's account is no longer on a Pro plan.

400

Missing query or malformed JSON body.

429

Rate limit reached — slow down and retry.

Create an API key Try it in the app