βœ‹ Palmistry API and 🎧 Audio Reports API are now live. Ship them in your app today.
Astrology JSON API

Astrology JSON API. Birth details in. Clean JSON out.

One API key gives your app birth charts, daily horoscopes, compatibility scores, numerology, panchang, KP and Human Design, with Western and Vedic side by side. All 300+ endpoints return the same clean format, so your team builds features, not calculation engines.

150 free credits to start. No credit card needed.

Example app screens powered by the API: daily horoscopes with sign, period and language pickers, compatibility scores, numerology and palm reading.

API families

12+

Western, Vedic, KP, Numerology, Tarot, Human Design, and more

Endpoints

300+

Charts, forecasts, compatibility, transits, AI readings β€” all pre-built

Languages

22

Horoscope feeds in 22 languages, with DST-aware timestamps

FULL COVERAGE

One integration. Every tradition.

Stop juggling providers. One integration covers every chart type, every tradition, every content format β€” with consistent schemas across the board.

πŸͺ

Charts & Core Calculations

Every natal data point your app needs β€” planets, houses, aspects, and strengths β€” in one structured response.

  • Western: Natal, synastry, solar & lunar return, progressed charts

  • Vedic: Kundli, all divisionals D1–D60, KP, Dasha timelines, Ashtakvarga

  • All values include degrees, retrogrades, lordships, and house strengths

Explore API Reference→
πŸ“…

Daily Content & Forecasts

Automated daily, weekly, and monthly content β€” no writers, no pipeline, no manual updates.

  • Sun sign and ascendant-based across 12 signs Γ— 5 life areas

  • 22+ languages, push-notification-ready formats included

  • Grounded in real transit data β€” not templated text

View Horoscope APIs→
🎯

Compatibility & Guidance

Compatibility scores, numerology profiles, and tarot β€” the features users actually pay for.

  • Vedic Guna Milan (36-point) and Western synastry with composite charts

  • Pythagorean numerology: life path, soul urge, personal year, Lo Shu grid

  • Tarot: 3-card, Celtic Cross, Yes/No, and Card of the Day

Explore API Docs→

LIVE DEMO

Predictable schemas. Instant integration.

Every endpoint uses consistent field naming and nesting β€” read the response once, parse it everywhere. Filter by tradition, request specific chart types, or deliver interpretation copy directly to your users.

Structured planet data β€” positions, speeds, retrogrades, and dignities

Interpretation text mapped by tradition: Western, Vedic, or KP

Metadata flags for retrograde, dignity, dispositor, and suggested next endpoints

1const myHeaders = new Headers();
2myHeaders.append("Content-Type", "application/x-www-form-urlencoded");
3myHeaders.append("Authorization", "Basic xxxx");
4
5const urlencoded = new URLSearchParams();
6urlencoded.append("timezone", "5.5");
7
8const requestOptions = {
9  method: "POST",
10  headers: myHeaders,
11  body: urlencoded,
12  redirect: "follow"
13};
14
15fetch("https://json.astrologyapi.com/v1/sun_sign_prediction/daily/virgo", requestOptions)
16  .then((response) => response.text())
17  .then((result) => console.log(result))
18  .catch((error) => console.error(error));

VEDIC & JYOTISH

The complete Vedic astrology data stack.

D1 to D60 divisional charts, Vimshottari and Yogini Dasha, Ashtakvarga, Bhavbala, Gochara, and KP sub-lords β€” every calculation the Vedic community expects, production-ready.

Basic Astro Details

birth details, astro details, etc...

Monthly Muhurta

monthly muhurta, monthly muhurta, etc...

Biorhythm

biorhythm, moon biorhythm

Horoscope Charts

horo chart, horo chart image

Ashtakvarga

planet ashtak, sarvashtak

Numerology

numero table, numero report, etc...

Life Reports

general house report, general rashi report, etc...

Lalkitab

lalkitab horoscope, lalkitab debts, etc...

Daily Nakshatra Predictions

daily nakshatra prediction, daily nakshatra prediction, etc...

Geo Details

geo details, timezone with dst

Monthly Panchang Yoga

monthly-panchang-yogas, monthly-panchang-yogas, etc...

Panchang

basic panchang, basic panchang, etc...

Match Making

match birth details, match ashtakoot points, etc...

Horoscope Dosha

simple manglik, manglik, etc...

Suggestions And Remedies

puja suggestion, basic gem suggestion, etc...

Varshaphal

varshaphal year chart, varshaphal month chart, etc...

Krishnamurti Paddhati

kp planets, kp house cusps, etc...

Vimshottari Dasha

current vdasha all, major vdasha, etc...

Char Dasha

major chardasha, current chardasha, etc...

Yogini Dasha

major yogini dasha, sub yogini dasha, etc...

TROPICAL & MODERN

The complete Western astrology toolkit.

Natal charts, synastry, composite charts, solar arc, progressions, transits, and AstroCartoGraphy β€” the full Western stack in one integration.

Natal Chart

western chart data, western horoscope, planets, etc...

Compatibility

personality report, friendship report, karma destiny report, etc...

Numerology

numerological numbers, lifepath number, personality number, etc...

Solar Return

solar return details, solar return planets, solar return house cusps, etc...

Synastry

romantic forecast report, composite horoscope, synastry horoscope

Transit

tropical transits, tropical transits, tropical transits, etc...

Moon Phases

lunar metrics, moon phase report

What the Astrology JSON API returns

Our Astrology JSON API is the data layer behind astrology features. You send birth details, a date or a zodiac sign. We return structured JSON with the same field style across every endpoint.

It covers 300+ endpoints in Vedic and Western astrology, plus numerology, tarot and more. You build the screens. We handle the calculations, the forecast text and the chart images.

  • Birth charts

    Planet positions, signs, houses and aspects for Vedic and Western charts.

  • Horoscopes

    Daily, weekly and monthly forecasts for all twelve signs, ready to show.

  • Compatibility

    Ashtakoot scores, synastry and zodiac compatibility for two people.

  • Timing

    Dasha periods, transits, panchang and solar returns for any date.

  • Reports and charts

    Written reports, chart images and branded PDF files.

  • Numerology and tarot

    Number reports, tarot draws and more from the same key.

Key endpoints with sample JSON

Four calls show the range. Each one is a POST, and each sample is real output from our docs, cut short.

Base URL: https://json.astrologyapi.com/v1

POST/astro_details

Vedic birth details

Returns the Vedic basics for one birth: ascendant, moon sign, nakshatra, tithi and more.

1{
2  "ascendant": "Leo",
3  "sign": "Virgo",
4  "SignLord": "Mercury",
5  "Naksahtra": "Uttra Phalguni",
6  "NaksahtraLord": "Sun",
7  "Charan": 3,
8  "Tithi": "Krishna Dwadashi",
9  "tatva": "Earth"
10}
Read the /astro_details reference β†’
POST/western_horoscope

Western natal chart

Returns tropical planets, houses, aspects and angles for one birth in a single call.

1{
2  "planets": [
3    {
4      "name": "Moon",
5      "full_degree": 12.271,
6      "norm_degree": 12.271,
7      "is_retro": "false",
8      "sign": "Aries",
9      "house": 5
10    }
11  ],
12  "ascendant": 240.71431015862024,
13  "midheaven": 156.92135925483103
14}
Read the /western_horoscope reference β†’
POST/sun_sign_prediction/daily/:zodiacName

Daily horoscope

Put the sign in the URL. You get today’s forecast in six life areas.

1{
2  "personal_life": "...",
3  "profession": "...",
4  "health": "...",
5  "emotions": "...",
6  "travel": "...",
7  "luck": "..."
8}
Read the daily horoscope reference β†’
POST/match_ashtakoot_points

Compatibility score

Send two births. You get points for each of the eight koots, a total out of 36 and a short conclusion.

1{
2  "total": {
3    "total_points": 36,
4    "received_points": 21,
5    "minimum_required": 18
6  },
7  "conclusion": {
8    "status": true
9  }
10}
Read the /match_ashtakoot_points reference β†’

Who uses the Astrology JSON API

More than 3,000+ businesses build on AstrologyAPI. Here is what they make with it.

Astrology apps

Birth charts, daily horoscopes and reports power the core screens of many astrology apps.

How to build an astrology app β†’

Dating and matrimony platforms

Compatibility scores give users one more reason to open a profile and send a message.

Compatibility for dating apps β†’

Publishers and newsletters

Daily horoscopes for all twelve signs fill sign pages, emails and push alerts every day.

Horoscope API β†’

AI assistants and agents

Real chart data keeps AI answers grounded. Our MCP server gives agents the same endpoints.

Astrology MCP server β†’

Vedic astrology products

Kundli, dasha, matching and panchang for apps that follow Jyotish.

Vedic Astrology API β†’

Western astrology products

Natal charts, wheel images, synastry and transits for tropical astrology apps.

Western Astrology API β†’

Astrology JSON API FAQ

What is an astrology JSON API?

It is a web service that does astrology math and returns the result as JSON. You send birth details or a zodiac sign. We send back planets, houses, scores or forecast text in a fixed format. Your app reads the fields and shows them. You do not need an ephemeris or an astrologer on staff.

How do I authenticate?

Our JSON API uses Basic Auth. Your user ID is the username and your API key is the password. You find both in your dashboard as soon as you sign up.

What does a request look like?

Every endpoint is a POST to https://json.astrologyapi.com/v1/ plus the endpoint name. Birth chart endpoints take day, month, year, hour, min, lat, lon and tzone. Sun sign horoscopes take the sign in the URL and an optional timezone in the body.

Does it cover both Vedic and Western astrology?

Yes. One key gives you 300+ endpoints across Vedic, Western, KP, numerology, tarot, Human Design and more. You can use one system or both side by side.

Can I call the API from the browser?

Call it from your server, not the browser. That keeps your API key private. Most teams add a small backend route, for example a Next.js API route, that calls us and passes the JSON to the app.

How much does it cost to start?

Signing up is free and gives you 150 credits. No credit card is needed. After that you can pick a monthly plan or pay as you go. Each endpoint has its own credit cost, shown on our pricing page.

Start shipping astrology features today.

Sandbox access in minutes, self-serve. 150 free credits to explore any endpoint. No credit card required.