Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Data → Planetary Positions

AI-generated

Summary

Calculate planetary positions for a specific birth date, time, and location to obtain astrological planetary data.

Inputs

  • Year (required) — Birth year in 4-digit format (e.g., 1990).
  • Month (required) — Birth month as a number from 1 (January) to 12 (December).
  • Day (required) — Birth day of the month from 1 to 31.
  • Hour (required) — Birth hour in 24-hour format (0=midnight, 12=noon) from 0 to 23.
  • Minute (required) — Birth minute from 0 to 59.
  • Location Type (required) — Method to specify birth location: either by city name (with auto coordinate detection) or by explicit geographic coordinates.
  • City (required) — Birth city name, required if Location Type is City Name.
  • Country Code (required) — 2-letter ISO country code of the birth city, required if Location Type is City Name.
  • Latitude (required) — Geographic latitude in decimal degrees (-90 to 90, positive north), required if Location Type is Coordinates.
  • Longitude (required) — Geographic longitude in decimal degrees (-180 to 180, positive east), required if Location Type is Coordinates.
  • Simplify — Option to return a simplified response with key data only (defaults to true). Disable to get the full API response including all metadata.

Output shape

a JSON object containing planetary position data for the specified birth datetime and location

The output can be simplified according to the 'Simplify' input parameter, providing either a reduced set of key fields or the full detailed API response. No pagination applies.

Examples

Example 1: Calculate planetary positions for a birth on June 15, 1990, at 14:30 in London, UK by city name.

Year=1990, Month=6, Day=15, Hour=14, Minute=30, Location Type=City Name, City='London', Country Code='GB', Simplify=true

Example 2: Calculate planetary positions for birth at exact coordinates 50.45 N, 30.52 E on January 1, 1990, at noon, requesting full detailed data.

Year=1990, Month=1, Day=1, Hour=12, Minute=0, Location Type=Coordinates, Latitude=50.45, Longitude=30.52, Simplify=false

Links

Discussion