v1

latestOpenAPI 3.1.02026-07-1320226.4 KB

Get Astrology Data

Get core astrological ephemeris data: planetary positions, house cusps, and aspects.

Returns raw astronomical data without interpretative elements like zodiac signs, elements, or modalities (which can be derived from longitude).

Plans:

  • FREE: Sun, Moon, Ascendant, 5 inner planets (Mercury-Saturn), 12 house cusps
  • BASIC: All FREE features + aspects between planets
  • PRO/ULTRA/MEGA: All BASIC features + outer planets (Uranus, Neptune, Pluto)

Returns:

  • meta: timestamp, location, house system, coordinate system, zodiac type, ephemeris source, reference frame, longitude type, equinox, orb rules
  • points: exact ecliptic longitude, latitude, and house placement for all bodies
  • houses: 12 house cusps (Equal House System), ascendant, midheaven
  • aspects: major aspects with orbs (BASIC+ plans only)

All coordinates are in degrees. House system is "equal" (from Ascendant). Coordinate system is "tropical" using PyEphem ephemeris. Reference frame is "geocentric", longitude type is "apparent", equinox is "date" (apparent of date).

get/astrology

Query parameters

latnumber nullable

Latitude

Latitude

lonnumber nullable

Longitude

Longitude

timestampinteger nullable

Unix timestamp (UTC)

Unix timestamp (UTC)

planstring

Plan type: FREE, BASIC, PRO, ULTRA, MEGA

Plan type: FREE, BASIC, PRO, ULTRA, MEGA

planoverridestring nullable

Headers

planstring nullable
x-rapidapi-userstring nullable

Response

Successful Response

{"stackTrail":"paths:/astrology:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}