/astrology namespace · APlicious

Astrology API for developers — natal charts, transits, synastry, and daily horoscopes

Build astrology apps, horoscope widgets, and compatibility tools without writing any ephemeris logic. APlicious computes natal charts, daily transits, synastry aspects, and retrograde periods from Swiss Ephemeris on every request.

20astrology endpoints

Get free API key View docs

GET /api/v1/astrology/natal-chart

const res = await fetch(
  'https://aplicious.com/api/v1/astrology/natal-chart' +
  '?datetime=1990-01-01T12:00:00Z&lat=28.6139&lon=77.2090',
  { headers: { 'X-API-Key': 'lapi_live_••••' } }
);
const { data } = await res.json();
// { sun: { sign: "Capricorn", degrees: 10.8, house: 10 },
//   moon: { sign: "Pisces", degrees: 22.4, house: 12 },
//   ascendant: { sign: "Aries", degrees: 14.3 },
//   aspects: [{ planet1: "Sun", planet2: "Saturn", type: "Conjunction", orb: 2.1 }] }

No credit card · Free to start · X-API-Key header auth

What's included in /astrology

Natal chart

Pass datetime + lat/lon for a complete natal chart: 10 planets, 12 houses, Ascendant, Midheaven, and all major aspects.

Planet positions

Get geocentric or topocentric planet positions for any datetime — tropical zodiac, degrees, retrograde flag.

Transits

Compare natal positions to a transit date — useful for daily/weekly transit report features.

Synastry

Cross-aspect table for two birth charts — used to build compatibility and relationship analysis features.

Retrograde detection

GET /astrology/retrograde for current and upcoming retrograde periods for all 10 classical planets.

Start using the astrology API for developers today

Free tier — 250 calls/month, no credit card. Upgrade when you need more.

Get free API key Explore /astrology docs

Frequently asked questions

Is this Western (tropical) or Vedic (sidereal)?

This namespace uses tropical zodiac (Western). For Vedic/sidereal charts with Lahiri ayanamsa, use /vedic/kundli instead.

Which house system is used?

Placidus by default — the most widely used house system in Western astrology. Equal houses and whole sign are also supported.

Can I get daily horoscopes?

Yes — GET /astrology/daily-horoscope?sign=Aries&datetime=... returns an AI-narrative-style daily reading based on current transits.

How accurate are the planet positions?

Swiss Ephemeris accuracy — sub-arcsecond precision, same engine used by professional astrologers worldwide.

Related API guides

One key unlocks all 22 namespaces — finance, legal, property, jobs, wellness, and more.

View all plans and pricing →