🌍 Astrocartography API and ✋ Palmistry API are now live. Ship them in your app today.Get Started

Category Based Location

POSThttps://json.astrologyapi.com/v1/acg/category-location/:category
Copy

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.

POST/acg/category-location/:category
Copy
1curl --location 'https://json.astrologyapi.com/v1/acg/category-location/:category' \
2  --header 'Content-Type: application/json' \
3  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
4  --data '{
5    "day": 22,
6    "month": 8,
7    "year": 1999,
8    "hour": 18,
9    "min": 50,
10    "second": 0,
11    "tzone": 5.5,
12    "lat": 19.0759837,
13    "lon": 72.8776559,
14    "include_parans": "false"
15}'
16
200Response
Copy
1{
2  "category": "LOVE",
3  "lines": [
4    {
5      "object": "Venus",
6      "zenith_latitude_deg": 5.156439,
7      "asc": {
8        "kind": "curve",
9        "line_type": "AC",
10        "points": [
11          {
12            "latitude_deg": 80,
13            "longitude_deg": -145.958784
14          },
15          {
16            "latitude_deg": 75,
17            "longitude_deg": -134.857293
18          },
19          {
20            "latitude_deg": 70,
21            "longitude_deg": -129.531616
22          },
23          {
24            "latitude_deg": 65,
25            "longitude_deg": -126.334697
26          },
27          {
28            "latitude_deg": 60,
29            "longitude_deg": -124.1686
30          },
31          {
32            "latitude_deg": 55,
33            "longitude_deg": -122.581024
34          },
35          {
36            "latitude_deg": 50,
37            "longitude_deg": -121.350114
38          },
39          {
40            "latitude_deg": 45,
41            "longitude_deg": -120.353774
42          },
43          {
44            "latitude_deg": 40,
45            "longitude_deg": -119.518967
46          },
47          {
48            "latitude_deg": 35,
49            "longitude_deg": -118.799095
50          },
51          {
52            "latitude_deg": 30,
53            "longitude_deg": -118.162812
54          },
55          {
56            "latitude_deg": 25,
57            "longitude_deg": -117.588037
58          },
59          {
60            "latitude_deg": 20,
61            "longitude_deg": -117.058537
62          },
63          {
64            "latitude_deg": 15,
65            "longitude_deg": -116.561866
66          },
67          {
68            "latitude_deg": 10,
69            "longitude_deg": -116.088045
70          },
71          {
72            "latitude_deg": 5,
73            "longitude_deg": -115.628681
74          },
75          {
76            "latitude_deg": 0,
77            "longitude_deg": -115.176325
78          },
79          {
80            "latitude_deg": -5,
81            "longitude_deg": -114.723968
82          },
83          {
84            "latitude_deg": -10,
85            "longitude_deg": -114.264604
86          },
87          {
88            "latitude_deg": -15,
89            "longitude_deg": -113.790784
90          },
91          {
92            "latitude_deg": -20,
93            "longitude_deg": -113.294113
94          },
95          {
96            "latitude_deg": -25,
97            "longitude_deg": -112.764613
98          },
99          {
100            "latitude_deg": -30,
101            "longitude_deg": -112.189838
102          },
103          {
104            "latitude_deg": -35,
105            "longitude_deg": -111.553554
106          },
107          {
108            "latitude_deg": -40,
109            "longitude_deg": -110.833683
110          },
111          {
112            "latitude_deg": -45,
113            "longitude_deg": -109.998876
114          },
115          {
116            "latitude_deg": -50,
117            "longitude_deg": -109.002535
118          },
119          {
120            "latitude_deg": -55,
121            "longitude_deg": -107.771625
122          },
123          {
124            "latitude_deg": -60,
125            "longitude_deg": -106.184049
126          },
127          {
128            "latitude_deg": -65,
129            "longitude_deg": -104.017953
130          },
131          {
132            "latitude_deg": -70,
133            "longitude_deg": -100.821034
134          },
135          {
136            "latitude_deg": -75,
137            "longitude_deg": -95.495357
138          },
139          {
140            "latitude_deg": -80,
141            "longitude_deg": -84.393865
142          }
143        ]
144      },
145      "dsc": {
146        "kind": "curve",
147        "line_type": "DC",
148        "points": [
149          {
150            "latitude_deg": 80,
151            "longitude_deg": 95.606135
152          },
153          {
154            "latitude_deg": 75,
155            "longitude_deg": 84.504643
156          },
157          {
158            "latitude_deg": 70,
159            "longitude_deg": 79.178966
160          },
161          {
162            "latitude_deg": 65,
163            "longitude_deg": 75.982047
164          },
165          {
166            "latitude_deg": 60,
167            "longitude_deg": 73.815951
168          },
169          {
170            "latitude_deg": 55,
171            "longitude_deg": 72.228375
172          },
173          {
174            "latitude_deg": 50,
175            "longitude_deg": 70.997465
176          },
177          {
178            "latitude_deg": 45,
179            "longitude_deg": 70.001124
180          },
181          {
182            "latitude_deg": 40,
183            "longitude_deg": 69.166317
184          },
185          {
186            "latitude_deg": 35,
187            "longitude_deg": 68.446446
188          },
189          {
190            "latitude_deg": 30,
191            "longitude_deg": 67.810162
192          },
193          {
194            "latitude_deg": 25,
195            "longitude_deg": 67.235387
196          },
197          {
198            "latitude_deg": 20,
199            "longitude_deg": 66.705887
200          },
201          {
202            "latitude_deg": 15,
203            "longitude_deg": 66.209216
204          },
205          {
206            "latitude_deg": 10,
207            "longitude_deg": 65.735396
208          },
209          {
210            "latitude_deg": 5,
211            "longitude_deg": 65.276032
212          },
213          {
214            "latitude_deg": 0,
215            "longitude_deg": 64.823675
216          },
217          {
218            "latitude_deg": -5,
219            "longitude_deg": 64.371319
220          },
221          {
222            "latitude_deg": -10,
223            "longitude_deg": 63.911955
224          },
225          {
226            "latitude_deg": -15,
227            "longitude_deg": 63.438134
228          },
229          {
230            "latitude_deg": -20,
231            "longitude_deg": 62.941463
232          },
233          {
234            "latitude_deg": -25,
235            "longitude_deg": 62.411963
236          },
237          {
238            "latitude_deg": -30,
239            "longitude_deg": 61.837188
240          },
241          {
242            "latitude_deg": -35,
243            "longitude_deg": 61.200905
244          },
245          {
246            "latitude_deg": -40,
247            "longitude_deg": 60.481033
248          },
249          {
250            "latitude_deg": -45,
251            "longitude_deg": 59.646226
252          },
253          {
254            "latitude_deg": -50,
255            "longitude_deg": 58.649886
256          },
257          {
258            "latitude_deg": -55,
259            "longitude_deg": 57.418976
260          },
261          {
262            "latitude_deg": -60,
263            "longitude_deg": 55.8314
264          },
265          {
266            "latitude_deg": -65,
267            "longitude_deg": 53.665303
268          },
269          {
270            "latitude_deg": -70,
271            "longitude_deg": 50.468384
272          },
273          {
274            "latitude_deg": -75,
275            "longitude_deg": 45.142707
276          },
277          {
278            "latitude_deg": -80,
279            "longitude_deg": 34.041216
280          }
281        ]
282      },
283      "ic": {
284        "kind": "meridian",
285        "line_type": "IC",
286        "longitude_deg": 154.823675
287      },
288      "mc": {
289        "kind": "meridian",
290        "line_type": "MC",
291        "longitude_deg": -25.176325
292      }
293    },
294    {
295      "object": "Moon",
296      "zenith_latitude_deg": -20.166033,
297      "asc": {
298        "kind": "curve",
299        "line_type": "AC",
300        "points": [
301          {
302            "latitude_deg": 65,
303            "longitude_deg": 69.219415
304          },
305          {
306            "latitude_deg": 60,
307            "longitude_deg": 56.76131
308          },
309          {
310            "latitude_deg": 55,
311            "longitude_deg": 48.893578
312          },
313          {
314            "latitude_deg": 50,
315            "longitude_deg": 43.215138
316          },
317          {
318            "latitude_deg": 45,
319            "longitude_deg": 38.80577
320          },
321          {
322            "latitude_deg": 40,
323            "longitude_deg": 35.207931
324          },
325          {
326            "latitude_deg": 35,
327            "longitude_deg": 32.160636
328          },
329          {
330            "latitude_deg": 30,
331            "longitude_deg": 29.500955
332          },
333          {
334            "latitude_deg": 25,
335            "longitude_deg": 27.120057
336          },
337          {
338            "latitude_deg": 20,
339            "longitude_deg": 24.941041
340          },
341          {
342            "latitude_deg": 15,
343            "longitude_deg": 22.906695
344          },
345          {
346            "latitude_deg": 10,
347            "longitude_deg": 20.972222
348          },
349          {
350            "latitude_deg": 5,
351            "longitude_deg": 19.100588
352          },
353          {
354            "latitude_deg": 0,
355            "longitude_deg": 17.259319
356          },
357          {
358            "latitude_deg": -5,
359            "longitude_deg": 15.418049
360          },
361          {
362            "latitude_deg": -10,
363            "longitude_deg": 13.546416
364          },
365          {
366            "latitude_deg": -15,
367            "longitude_deg": 11.611942
368          },
369          {
370            "latitude_deg": -20,
371            "longitude_deg": 9.577597
372          },
373          {
374            "latitude_deg": -25,
375            "longitude_deg": 7.398581
376          },
377          {
378            "latitude_deg": -30,
379            "longitude_deg": 5.017683
380          },
381          {
382            "latitude_deg": -35,
383            "longitude_deg": 2.358001
384          },
385          {
386            "latitude_deg": -40,
387            "longitude_deg": -0.689294
388          },
389          {
390            "latitude_deg": -45,
391            "longitude_deg": -4.287132
392          },
393          {
394            "latitude_deg": -50,
395            "longitude_deg": -8.696501
396          },
397          {
398            "latitude_deg": -55,
399            "longitude_deg": -14.374941
400          },
401          {
402            "latitude_deg": -60,
403            "longitude_deg": -22.242673
404          },
405          {
406            "latitude_deg": -65,
407            "longitude_deg": -34.700777
408          }
409        ]
410      },
411      "dsc": {
412        "kind": "curve",
413        "line_type": "DC",
414        "points": [
415          {
416            "latitude_deg": 65,
417            "longitude_deg": 145.299223
418          },
419          {
420            "latitude_deg": 60,
421            "longitude_deg": 157.757327
422          },
423          {
424            "latitude_deg": 55,
425            "longitude_deg": 165.625059
426          },
427          {
428            "latitude_deg": 50,
429            "longitude_deg": 171.303499
430          },
431          {
432            "latitude_deg": 45,
433            "longitude_deg": 175.712868
434          },
435          {
436            "latitude_deg": 40,
437            "longitude_deg": 179.310706
438          },
439          {
440            "latitude_deg": 35,
441            "longitude_deg": -177.641999
442          },
443          {
444            "latitude_deg": 30,
445            "longitude_deg": -174.982317
446          },
447          {
448            "latitude_deg": 25,
449            "longitude_deg": -172.601419
450          },
451          {
452            "latitude_deg": 20,
453            "longitude_deg": -170.422403
454          },
455          {
456            "latitude_deg": 15,
457            "longitude_deg": -168.388058
458          },
459          {
460            "latitude_deg": 10,
461            "longitude_deg": -166.453584
462          },
463          {
464            "latitude_deg": 5,
465            "longitude_deg": -164.581951
466          },
467          {
468            "latitude_deg": 0,
469            "longitude_deg": -162.740681
470          },
471          {
472            "latitude_deg": -5,
473            "longitude_deg": -160.899412
474          },
475          {
476            "latitude_deg": -10,
477            "longitude_deg": -159.027778
478          },
479          {
480            "latitude_deg": -15,
481            "longitude_deg": -157.093305
482          },
483          {
484            "latitude_deg": -20,
485            "longitude_deg": -155.058959
486          },
487          {
488            "latitude_deg": -25,
489            "longitude_deg": -152.879943
490          },
491          {
492            "latitude_deg": -30,
493            "longitude_deg": -150.499045
494          },
495          {
496            "latitude_deg": -35,
497            "longitude_deg": -147.839364
498          },
499          {
500            "latitude_deg": -40,
501            "longitude_deg": -144.792069
502          },
503          {
504            "latitude_deg": -45,
505            "longitude_deg": -141.19423
506          },
507          {
508            "latitude_deg": -50,
509            "longitude_deg": -136.784862
510          },
511          {
512            "latitude_deg": -55,
513            "longitude_deg": -131.106422
514          },
515          {
516            "latitude_deg": -60,
517            "longitude_deg": -123.23869
518          },
519          {
520            "latitude_deg": -65,
521            "longitude_deg": -110.780585
522          }
523        ]
524      },
525      "ic": {
526        "kind": "meridian",
527        "line_type": "IC",
528        "longitude_deg": -72.740681
529      },
530      "mc": {
531        "kind": "meridian",
532        "line_type": "MC",
533        "longitude_deg": 107.259319
534      }
535    }
536  ],
537  "planets": [
538    "Venus",
539    "Moon"
540  ]
541}

Request Headers

x-astrologyapi-key

string

required

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

Accept-Language

string

Preferred language for the response content

Properties

English - en

Request Body (JSON)

day

number

required

Day of birth (1-31).

month

number

required

Month of birth (1-12).

year

number

required

Year of birth.

hour

number

required

Hour of birth (0-23).

min

number

required

Minute of birth (0-59).

second

number

Second of birth (0-59).

tzone

number

required

Timezone offset from UTC in hours.

lat

number

required

Latitude of birth place.

lon

number

required

Longitude of birth place.

include_parans

boolean

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

Path Parameters

category

string

required

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

Properties

ADVENTURECAREERCOMMUNICATIONCREATIVITYHEALTHLEARNINGLOVEMONEYPOWERRELATIONSHIPSPIRITUALITYSUCCESSTRANSFORMATIONTRAVELVITALITYWEALTH

Errors

400
Bad Request

Something is wrong with your request format or parameters.

401
Unauthorized

Your API key is missing or invalid.

403
Forbidden

You don't have permission to access this specific resource.

404
Not Found

The API endpoint you're trying to reach doesn't exist.

500
Internal Server Error

Our server is having a temporary glitch.