🌍 Astrocartography API, 🔷 Human Design API and ✋ Palmistry API are now live. Ship them in your app today.

Category Based Location

Returns only the astrocartography lines for the planets tied to a chosen life category. Maps a life theme (love, career, money, etc.) to its associated planets and returns just those planets' angle lines, so you can highlight the places on Earth that favor that area of life rather than drawing the whole map. Use it for themed "best places for love/career" map views.
POSThttps://json.astrologyapi.com/v1/acg/category-location/:category

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en.

Path parameters

categorystringrequired

The life category to filter lines by. Determines which planets are included.

  • ADVENTURE
  • CAREER
  • COMMUNICATION
  • CREATIVITY
  • HEALTH
  • LEARNING
  • LOVE
  • MONEY
  • POWER
  • RELATIONSHIP
  • SPIRITUALITY
  • SUCCESS
  • TRANSFORMATION
  • TRAVEL
  • VITALITY
  • WEALTH

Body parameters

daynumberrequired

Day of birth (1-31).

monthnumberrequired

Month of birth (1-12).

yearnumberrequired

Year of birth.

hournumberrequired

Hour of birth (0-23).

minnumberrequired

Minute of birth (0-59).

secondnumber

Second of birth (0-59).

tzonenumberrequired

Timezone offset from UTC in hours.

latnumberrequired

Latitude of birth place.

lonnumberrequired

Longitude of birth place.

include_paransboolean

Set to true to also return paran latitude-crossing lines. Default: false.

curl --location 'https://json.astrologyapi.com/v1/acg/category-location/LOVE' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "day": 22,
    "month": 8,
    "year": 1999,
    "hour": 18,
    "min": 50,
    "second": 0,
    "tzone": 5.5,
    "lat": 19.0759837,
    "lon": 72.8776559,
    "include_parans": "false"
}'
Try it

Runs with sample data — no API key needed

{
  "category": "LOVE",
  "lines": [
    {
      "object": "Venus",
      "zenith_latitude_deg": 5.156439,
      "asc": {
        "kind": "curve",
        "line_type": "AC",
        "points": [
          {
            "latitude_deg": 80,
            "longitude_deg": -145.958784
          },
          {
            "latitude_deg": 75,
            "longitude_deg": -134.857293
          },
          {
            "latitude_deg": 70,
            "longitude_deg": -129.531616
          },
          {
            "latitude_deg": 65,
            "longitude_deg": -126.334697
          },
          {
            "latitude_deg": 60,
            "longitude_deg": -124.1686
          },
          {
            "latitude_deg": 55,
            "longitude_deg": -122.581024
          },
          {
            "latitude_deg": 50,
            "longitude_deg": -121.350114
          },
          {
            "latitude_deg": 45,
            "longitude_deg": -120.353774
          },
          {
            "latitude_deg": 40,
            "longitude_deg": -119.518967
          },
          {
            "latitude_deg": 35,
            "longitude_deg": -118.799095
          },
          {
            "latitude_deg": 30,
            "longitude_deg": -118.162812
          },
          {
            "latitude_deg": 25,
            "longitude_deg": -117.588037
          },
          {
            "latitude_deg": 20,
            "longitude_deg": -117.058537
          },
          {
            "latitude_deg": 15,
            "longitude_deg": -116.561866
          },
          {
            "latitude_deg": 10,
            "longitude_deg": -116.088045
          },
          {
            "latitude_deg": 5,
            "longitude_deg": -115.628681
          },
          {
            "latitude_deg": 0,
            "longitude_deg": -115.176325
          },
          {
            "latitude_deg": -5,
            "longitude_deg": -114.723968
          },
          {
            "latitude_deg": -10,
            "longitude_deg": -114.264604
          },
          {
            "latitude_deg": -15,
            "longitude_deg": -113.790784
          },
          {
            "latitude_deg": -20,
            "longitude_deg": -113.294113
          },
          {
            "latitude_deg": -25,
            "longitude_deg": -112.764613
          },
          {
            "latitude_deg": -30,
            "longitude_deg": -112.189838
          },
          {
            "latitude_deg": -35,
            "longitude_deg": -111.553554
          },
          {
            "latitude_deg": -40,
            "longitude_deg": -110.833683
          },
          {
            "latitude_deg": -45,
            "longitude_deg": -109.998876
          },
          {
            "latitude_deg": -50,
            "longitude_deg": -109.002535
          },
          {
            "latitude_deg": -55,
            "longitude_deg": -107.771625
          },
          {
            "latitude_deg": -60,
            "longitude_deg": -106.184049
          },
          {
            "latitude_deg": -65,
            "longitude_deg": -104.017953
          },
          {
            "latitude_deg": -70,
            "longitude_deg": -100.821034
          },
          {
            "latitude_deg": -75,
            "longitude_deg": -95.495357
          },
          {
            "latitude_deg": -80,
            "longitude_deg": -84.393865
          }
        ]
      },
      "dsc": {
        "kind": "curve",
        "line_type": "DC",
        "points": [
          {
            "latitude_deg": 80,
            "longitude_deg": 95.606135
          },
          {
            "latitude_deg": 75,
            "longitude_deg": 84.504643
          },
          {
            "latitude_deg": 70,
            "longitude_deg": 79.178966
          },
          {
            "latitude_deg": 65,
            "longitude_deg": 75.982047
          },
          {
            "latitude_deg": 60,
            "longitude_deg": 73.815951
          },
          {
            "latitude_deg": 55,
            "longitude_deg": 72.228375
          },
          {
            "latitude_deg": 50,
            "longitude_deg": 70.997465
          },
          {
            "latitude_deg": 45,
            "longitude_deg": 70.001124
          },
          {
            "latitude_deg": 40,
            "longitude_deg": 69.166317
          },
          {
            "latitude_deg": 35,
            "longitude_deg": 68.446446
          },
          {
            "latitude_deg": 30,
            "longitude_deg": 67.810162
          },
          {
            "latitude_deg": 25,
            "longitude_deg": 67.235387
          },
          {
            "latitude_deg": 20,
            "longitude_deg": 66.705887
          },
          {
            "latitude_deg": 15,
            "longitude_deg": 66.209216
          },
          {
            "latitude_deg": 10,
            "longitude_deg": 65.735396
          },
          {
            "latitude_deg": 5,
            "longitude_deg": 65.276032
          },
          {
            "latitude_deg": 0,
            "longitude_deg": 64.823675
          },
          {
            "latitude_deg": -5,
            "longitude_deg": 64.371319
          },
          {
            "latitude_deg": -10,
            "longitude_deg": 63.911955
          },
          {
            "latitude_deg": -15,
            "longitude_deg": 63.438134
          },
          {
            "latitude_deg": -20,
            "longitude_deg": 62.941463
          },
          {
            "latitude_deg": -25,
            "longitude_deg": 62.411963
          },
          {
            "latitude_deg": -30,
            "longitude_deg": 61.837188
          },
          {
            "latitude_deg": -35,
            "longitude_deg": 61.200905
          },
          {
            "latitude_deg": -40,
            "longitude_deg": 60.481033
          },
          {
            "latitude_deg": -45,
            "longitude_deg": 59.646226
          },
          {
            "latitude_deg": -50,
            "longitude_deg": 58.649886
          },
          {
            "latitude_deg": -55,
            "longitude_deg": 57.418976
          },
          {
            "latitude_deg": -60,
            "longitude_deg": 55.8314
          },
          {
            "latitude_deg": -65,
            "longitude_deg": 53.665303
          },
          {
            "latitude_deg": -70,
            "longitude_deg": 50.468384
          },
          {
            "latitude_deg": -75,
            "longitude_deg": 45.142707
          },
          {
            "latitude_deg": -80,
            "longitude_deg": 34.041216
          }
        ]
      },
      "ic": {
        "kind": "meridian",
        "line_type": "IC",
        "longitude_deg": 154.823675
      },
      "mc": {
        "kind": "meridian",
        "line_type": "MC",
        "longitude_deg": -25.176325
      }
    },
    {
      "object": "Moon",
      "zenith_latitude_deg": -20.166033,
      "asc": {
        "kind": "curve",
        "line_type": "AC",
        "points": [
          {
            "latitude_deg": 65,
            "longitude_deg": 69.219415
          },
          {
            "latitude_deg": 60,
            "longitude_deg": 56.76131
          },
          {
            "latitude_deg": 55,
            "longitude_deg": 48.893578
          },
          {
            "latitude_deg": 50,
            "longitude_deg": 43.215138
          },
          {
            "latitude_deg": 45,
            "longitude_deg": 38.80577
          },
          {
            "latitude_deg": 40,
            "longitude_deg": 35.207931
          },
          {
            "latitude_deg": 35,
            "longitude_deg": 32.160636
          },
          {
            "latitude_deg": 30,
            "longitude_deg": 29.500955
          },
          {
            "latitude_deg": 25,
            "longitude_deg": 27.120057
          },
          {
            "latitude_deg": 20,
            "longitude_deg": 24.941041
          },
          {
            "latitude_deg": 15,
            "longitude_deg": 22.906695
          },
          {
            "latitude_deg": 10,
            "longitude_deg": 20.972222
          },
          {
            "latitude_deg": 5,
            "longitude_deg": 19.100588
          },
          {
            "latitude_deg": 0,
            "longitude_deg": 17.259319
          },
          {
            "latitude_deg": -5,
            "longitude_deg": 15.418049
          },
          {
            "latitude_deg": -10,
            "longitude_deg": 13.546416
          },
          {
            "latitude_deg": -15,
            "longitude_deg": 11.611942
          },
          {
            "latitude_deg": -20,
            "longitude_deg": 9.577597
          },
          {
            "latitude_deg": -25,
            "longitude_deg": 7.398581
          },
          {
            "latitude_deg": -30,
            "longitude_deg": 5.017683
          },
          {
            "latitude_deg": -35,
            "longitude_deg": 2.358001
          },
          {
            "latitude_deg": -40,
            "longitude_deg": -0.689294
          },
          {
            "latitude_deg": -45,
            "longitude_deg": -4.287132
          },
          {
            "latitude_deg": -50,
            "longitude_deg": -8.696501
          },
          {
            "latitude_deg": -55,
            "longitude_deg": -14.374941
          },
          {
            "latitude_deg": -60,
            "longitude_deg": -22.242673
          },
          {
            "latitude_deg": -65,
            "longitude_deg": -34.700777
          }
        ]
      },
      "dsc": {
        "kind": "curve",
        "line_type": "DC",
        "points": [
          {
            "latitude_deg": 65,
            "longitude_deg": 145.299223
          },
          {
            "latitude_deg": 60,
            "longitude_deg": 157.757327
          },
          {
            "latitude_deg": 55,
            "longitude_deg": 165.625059
          },
          {
            "latitude_deg": 50,
            "longitude_deg": 171.303499
          },
          {
            "latitude_deg": 45,
            "longitude_deg": 175.712868
          },
          {
            "latitude_deg": 40,
            "longitude_deg": 179.310706
          },
          {
            "latitude_deg": 35,
            "longitude_deg": -177.641999
          },
          {
            "latitude_deg": 30,
            "longitude_deg": -174.982317
          },
          {
            "latitude_deg": 25,
            "longitude_deg": -172.601419
          },
          {
            "latitude_deg": 20,
            "longitude_deg": -170.422403
          },
          {
            "latitude_deg": 15,
            "longitude_deg": -168.388058
          },
          {
            "latitude_deg": 10,
            "longitude_deg": -166.453584
          },
          {
            "latitude_deg": 5,
            "longitude_deg": -164.581951
          },
          {
            "latitude_deg": 0,
            "longitude_deg": -162.740681
          },
          {
            "latitude_deg": -5,
            "longitude_deg": -160.899412
          },
          {
            "latitude_deg": -10,
            "longitude_deg": -159.027778
          },
          {
            "latitude_deg": -15,
            "longitude_deg": -157.093305
          },
          {
            "latitude_deg": -20,
            "longitude_deg": -155.058959
          },
          {
            "latitude_deg": -25,
            "longitude_deg": -152.879943
          },
          {
            "latitude_deg": -30,
            "longitude_deg": -150.499045
          },
          {
            "latitude_deg": -35,
            "longitude_deg": -147.839364
          },
          {
            "latitude_deg": -40,
            "longitude_deg": -144.792069
          },
          {
            "latitude_deg": -45,
            "longitude_deg": -141.19423
          },
          {
            "latitude_deg": -50,
            "longitude_deg": -136.784862
          },
          {
            "latitude_deg": -55,
            "longitude_deg": -131.106422
          },
          {
            "latitude_deg": -60,
            "longitude_deg": -123.23869
          },
          {
            "latitude_deg": -65,
            "longitude_deg": -110.780585
          }
        ]
      },
      "ic": {
        "kind": "meridian",
        "line_type": "IC",
        "longitude_deg": -72.740681
      },
      "mc": {
        "kind": "meridian",
        "line_type": "MC",
        "longitude_deg": 107.259319
      }
    }
  ],
  "planets": [
    "Venus",
    "Moon"
  ]
}