Western Astrology APIs1. Securing Your API Key
To start, you need an API key. Head over to https://divineapi.com/ and register to initiate your 7-day trial.
- Select the APIs you are interested in; you can change these selections at any time. You can add or remove APIs in the future.
- Click on checkout, fill out the sign-up form, and enter your payment details on the next page.
Your trial will begin immediately. You won't be charged during the trial period, and you can cancel anytime without incurring any charges.
- After logging in, your API key will be visible on your dashboard on the API Key page ( https://divineapi.com/api-keys)
2. Importing the Postman Collection
Import our Postman collection to facilitate your API testing:
- After logging into your Postman account:
- Open This link: https://documenter.getpostman.com/view/27195761/2sA3Qs8rfV
- Click “Run in Postman” and then select “Run in Web”.
- Select your workspace and then select ‘import’.
3. Configuring Your API Request
Once the collection is imported:
- Locate the "Synastry Harmonious Aspect Reading" API request.
- Ensure the method is set to POST.
- Use this request URL: https://astroapi-4.divineapi.com/western-api/v1/synastry/harmonious-aspect-reading
4. Setting Request Parameters
This API call necessitates only your API key. To find your API key.
- Go to your DivineAPI dashboard > API Key page.
- Click on “Copy” next to the API key
Notice the difference between the key, and the Access Token.
Go back to Postman to set the parameters.
- Navigate to “Authorization”, select “Bearer Token” in the Auth type, and then add the token from your Divine API profile.
- Navigate to 'Body', select 'form_data', and then add:
- api_key: “<Your_API_Key>” - Your unique API subscription identifier.
- p1_full_name: “Person one” - Enter name.
- p1_day: “24” - Enter the date of birth.
- p1_month: “05” - Enter the month of birth.
- p1_year: "1998" - The year of interest.
- p1_hour: “14” - Enter the hour.
- p1_min: “40” - Enter the minute.
- p1_sec: “43” - Enter the second.
- p1_gender: “male” - Enter the gender.
- p1_place: "New Delhi" - The name of the city.
- p1_lat: "28.7041" - Latitude for location-specific details.
- p1_lon: "77.1025" - Longitude for accurate location insights.
- p1_tzone: "5.5" - Timezone offset from UTC.
- p2_full_name: “Person two” - Enter name.
- p2_day: “24” - Enter the date of birth.
- p2_month: “05” - Enter the month of birth.
- p2_year: "1998" - The year of interest.
- p2_hour: “14” - Enter the hour.
- p2_min: “40” - Enter the minute.
- p2_sec: “43” - Enter the second.
- p2_gender: “female” - Enter the gender.
- p2_place: "New Delhi" - The name of the city.
- p2_lat: "28.7041" - Latitude for location-specific details.
- p2_lon: "77.1025" - Longitude for accurate location insights.
- p2_tzone: "5.5" - Timezone offset from UTC.
- lan: “en” - Enter the language.
- Please ensure that the bearer token is exactly the same as in your profile, with no changes in spacing or formatting.
Use translator for other language:
Update translator: https://divineapi.com/translator
en For English
hi For Hindi
pt For Portuguese
fr For French
es For Spanish
ru For Russian
de For German
nl For Dutch
it For Italian
pl For Polish
ar For Arabic
ja For Japanese
zh For Chinese
5. Making the Request
Hit the 'Send' button to submit your request.
6. Deciphering the Response
The API's response will be structured as follows:
{
{
"success": 1,
"data": [
{
"p1": {
"planet": "Ascendant",
"full_degree": "185.7672390",
"sign": "Libra",
"sign_no": 7,
"longitude": "5:46:2"
},
"p2": {
"planet": "Neptune",
"full_degree": "302.0576072",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "2:3:27"
},
"orb": 3.71,
"aspect": "Trine",
"aspect_type": "Easy",
"reading": [
{
"title": "Spiritual Connection",
"description": "With Rahul Kumar's Ascendant Trine Simran Kumari’s Neptune, a strong spiritual and psychic connection is formed. Rahul Kumar might be greatly attuned to Simran Kumari's dreams, fantasies, and spiritual ventures, providing a feeling of deeper understanding."
},
{
"title": "Escapism Tendencies",
"description": "This configuration may also indicate a desire for escapism. Rahul Kumar may intuitively understand Simran Kumari's need to escape reality occasionally, providing a supportive environment. However, it could also enable or encourage pernicious escapism behaviors."
},
{
"title": "Emotional Understanding",
"description": "Emotionally, it can create a deep, non-verbal understanding between Rahul Kumar and Simran Kumari. Rahul Kumar can instinctively understand Simran Kumari's emotional states and innermost feelings, which can bring closeness but also a risk of misunderstanding if intuition is off."
}
]
},
{
"p1": {
"planet": "Ascendant",
"full_degree": "185.7672390",
"sign": "Libra",
"sign_no": 7,
"longitude": "5:46:2"
},
"p2": {
"planet": "Pluto",
"full_degree": "246.7995404",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "6:47:58"
},
"orb": 1.03,
"aspect": "Sextile",
"aspect_type": "Mildly Easy",
"reading": [
{
"title": "Intense Attraction",
"description": "When Rahul Kumar's Ascendant is in a Sextile aspect with Simran Kumari's Pluto, there's an intense and dynamic attraction. Rahul Kumar may feel mysteriously drawn to Simran Kumari, making the relationship magnetic and fascinating."
},
{
"title": "Transformational Influence",
"description": "Simran Kumari's Pluto may inspire Rahul Kumar to transform themselves in significant ways. It can lead to deep changes and rebirth, pushing Rahul Kumar out of their comfort zone to evolve and grow."
},
{
"title": "Power Dynamics",
"description": "Power dynamics may be significant in this relationship. Simran Kumari can influence Rahul Kumar in subtle, profound ways. This can lead to domination scenarios, where Simran Kumari exerts control, requiring maturity and understanding from both partners to balance."
}
]
},
{
"p1": {
"planet": "Sun",
"full_degree": "63.0091751",
"sign": "Gemini",
"sign_no": 3,
"longitude": "3:0:33"
},
"p2": {
"planet": "Ascendant",
"full_degree": "185.7672390",
"sign": "Libra",
"sign_no": 7,
"longitude": "5:46:2"
},
"orb": 2.76,
"aspect": "Trine",
"aspect_type": "Easy",
"reading": [
{
"title": "Easy Bonding",
"description": "When Rahul Kumar's Sun forms a trine aspect with Simran Kumari's Ascendant, it indicates a strong mutual understanding and easy flow of energy between the two individuals. There is a natural harmony and they easily blend with each other's way of expressing oneself."
},
{
"title": "Mutual Respect",
"description": "The Trine aspect fosters an environment of mutual respect and admiration. Rahul Kumar perceives Simran Kumari as a confident individual, respecting their unique personality and beliefs. This aspect builds a strong foundation for trust and respect in the relationship."
},
{
"title": "Creative Expansion",
"description": "With Rahul Kumar's Sun trine Simran Kumari's Ascendant, there are opportunities for the couple to grow creatively. The supportive condition of the trine aspect encourages both Rahul Kumar and Simran Kumari to explore new ideas and potentials, broadening their horizons and enriching their understanding of each other."
}
]
},
{
"p1": {
"planet": "Moon",
"full_degree": "43.0997128",
"sign": "Taurus",
"sign_no": 2,
"longitude": "13:5:59"
},
"p2": {
"planet": "North node",
"full_degree": "156.1323021",
"sign": "Virgo",
"sign_no": 6,
"longitude": "6:7:56"
},
"orb": 6.97,
"aspect": "Trine",
"aspect_type": "Easy",
"reading": [
{
"title": "Emotional Connection",
"description": "In synastry, Rahul Kumar's moon trine Simran Kumari's north node indicates a strong emotional connection. Rahul Kumar intuitively understands Simran Kumari's life path and purpose, establishing a deep emotional bond."
},
{
"title": "Karmic Link",
"description": "The moon trine north node aspect suggests a karmic link from past lives. This aspect often signifies a spiritual and emotional partnership, indicating Rahul Kumar and Simran Kumari have been together in previous incarnations."
},
{
"title": "Life Journey",
"description": "Rahul Kumar's emotional reactions and instincts are in harmony with Simran Kumari's spiritual growth and life's direction. This creates an ease between them which aids in the progression of Simran Kumari's life journey."
}
]
},
}- The provided response contains synastry aspect readings between two individuals.
- Each entry includes details about the planets involved, their positions, the aspect type (e.g., Trine, Sextile), and an "orb" value indicating the degree of separation.
- Each aspect has a set of readings that describe the relationship dynamics, such as "Spiritual Connection" or "Intense Attraction."
- Use these readings to understand the specific influences and interactions between the two individuals' planetary positions.
7. Error Resolution
Ensure your API key is correctly entered if you encounter errors, as most issues are due to invalid or missing API keys.
8. Further Assistance
For additional support or inquiries, feel free to contact our customer service team at admin@divineapi.com.