Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Astrocartography → Search Locations

AI-generated

Summary

Searches for optimal geographical locations based on the user's birth date, time, and location to identify best places for specified types of life power (e.g., career, creativity, love).

Inputs

  • Year (required) — Birth year in 4-digit format (e.g., 1990).
  • Month (required) — Birth month as number 1-12 (January=1, December=12).
  • Day (required) — Birth day of month (1-31).
  • Hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight, 12=noon).
  • Minute (required) — Birth minute (0-59).
  • Location Type (required) — Choose how to specify birth location: by city name (auto-detects coordinates) or exact latitude/longitude.
  • City (required) — Birth city name, required if Location Type is City Name (e.g., "London", "New York").
  • Country Code (required) — 2-letter ISO country code for the birth city, required if Location Type is City Name (e.g., US, GB, UA).
  • 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.
  • Power Type (required) — Kind of life influence to analyze, such as career, creativity, love, wealth, or overall.
  • Simplify — Whether to return a simplified response containing only key data (default true). Disable to receive the full API response with all metadata.

Output shape

a data object containing search results for best locations matching the specified power type based on the birth data and location input

The response can be returned in simplified form showing only essential keys if 'Simplify' is enabled; otherwise, the full raw API response with all metadata is returned.

Links

Discussion