API for Astrology

Use case

AI astrology API for assistants and chatbots

An AI assistant can talk about astrology, but it cannot calculate a chart. Asked for one, a language model often invents planet positions that look right and are not. Our API computes the real chart and returns plain answers with the rule behind each one, so your assistant quotes a result it can explain.

Get a free API keyTalk to us
POST /v1/dosha/manglik200 OK
{
  "dosha": "manglik",
  "rule": "Mars occupying house 1, 2, 4, 7, 8 or 12, counted separately from the ascendant, from the Moon and from Venus",
  "present": true,
  "cancellations": [
    "Mars is in its own sign"
  ],
  "answer": {
    "status": "present",
    "headline": "Manglik dosha is present, counted from your ascendant and your Moon. On its own this is very common: by this three-way check most charts show it from at least one place."
  }
}
John Doe's manglik dosha check: the rule it tested, an exception it found but did not apply, and the answer in plain English. Real output for John Doe, born Aug 15, 1990, 10:30 AM, New York.

How to give an AI assistant real astrology

  1. 01

    Summarize a chart

    POST /v1/summary

    A plain-language summary with no planet names or Sanskrit, ready for the model to quote. Each part says what it is based on.

  2. 02

    Answer dosha questions

    POST /v1/dosha/{name}

    Call it with all for manglik dosha, kaal sarp dosh and pitra dosh at once. Each result has an answer block: a status, a headline, what it means and what to do next.

  3. 03

    Check compatibility

    POST /v1/matching

    A one-word verdict, a headline, and the concerns and strengths behind it. The model can put the result in its own words without changing it.

  4. 04

    Answer a life question

    POST /v1/reading/section/{section_id}

    Career, love, wealth, personality or education, each opening with a direct answer. Use ids such as topic:professional-life.

  5. 05

    Talk about today

    POST /v1/reading/daily

    The day for one person: the Moon's position counted from their birth Moon, the slower planets and their running periods.

Tips for going live

  • Keep the API key on your server, inside the tool handler. Never put it in a prompt, a web page or a mobile app.
  • Offer the model a few tools, not all 42 endpoints, and tell it to quote the answer fields rather than add planet positions of its own. The AI assistants guide in the docs lists the fields.
  • Have the assistant ask for a missing birth time or place instead of guessing one.
  • The same birth details always give the same answer, so cache results and keep your tests stable.
  • Your AI provider still sees what users type, including birth details. Say so in your privacy notice.

Pricing

Every plan can call every endpoint. Test keys are free on every plan, with 1,000 requests a month. Paid plans start at $29 a month, and only successful calls count.

See pricing

Features used here

Astrology API

Start with a free test key

Create an account and a test key, then try each step above. Need more than the largest plan? Write to us.

  1. 01

    A free test key, with 1,000 requests a month

  2. 02

    Try any endpoint in your browser first

  3. 03

    Every rule published, so you can check any answer

Get a free API keyOpen the API reference