Best Cities for a Goal API
AvailableRanks catalogue cities for one life goal: score, distance, rising and midheaven signs with their lords, and the reasons for each.
Call it with POST /v1/location-astrology/rank-cities. Input: birth details. Output: JSON, as a direct response. Each successful call costs 3 credits. It offers 16 options, such as Career, Marriage and Wealth.
- Endpoint
- POST /v1/location-astrology/rank-cities
- Input
- Birth details
- Output
- JSON
- Delivery
- Direct response
- Cost
- 3 credits
- Compute class
- Heavy
Options
- Career
- Marriage
- Wealth
- Spiritual
- Health
- Education
- Peace of mind
- Children
- Property
- Romance
- Fame
- Foreign settlement
- Travel
- Politics
- Arts
- Business
Example response
Fields in data (inferred from the example)
goal· stringregion· stringformula· array of objectcities_in_catalogue· integercities_scored· integercities· array of object
Example response
Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and images are replaced by a placeholder.
Loading the example…
Request schema and every field: the Location astrology reference.
Best Cities for a Goal API: common questions
What does the Best Cities for a Goal API return?
Ranks catalogue cities for one life goal: score, distance, rising and midheaven signs with their lords, and the reasons for each. The response's data object includes goal, region, formula, cities_in_catalogue, cities_scored and cities. See the reference for an example response.
What input does Best Cities for a Goal need?
Birth details. It accepts 16 options, for example Career, Marriage and Wealth.
How much does a Best Cities for a Goal call cost?
3 credits per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.
Can I try it before paying?
Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.