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 Contrasting Aspect Reading" API request.
- Ensure the method is set to POST.
- Use this request URL: https://astroapi-4.divineapi.com/western-api/v1/synastry/contrasting-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": "Sun",
"full_degree": "63.0091751",
"sign": "Gemini",
"sign_no": 3,
"longitude": "3:0:33"
},
"p2": {
"planet": "Pluto",
"full_degree": "246.7995404",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "6:47:58"
},
"orb": 3.79,
"aspect": "Opposition",
"aspect_type": "Hard",
"reading": [
{
"title": "Power Struggles",
"description": "In this synastry aspect, Person one and Person two may find themselves in a consistent power struggle. Person two's Pluto opposition to Person one's Sun can result in conflict as both individuals vie to maintain control within the relationship."
},
{
"title": "Transformation Challenges",
"description": "Person one may be forced to undergo transformations they are not comfortable with due to the intense influence of Person two’s Pluto. Unless handled delicately, this can bring about upheaval and distress in the relationship."
},
{
"title": "Intense Attraction",
"description": "Despite the challenges, this opposition can also bring about an intensely magnetic attraction between Person one and Person two. This passionate energy might translate to an irresistible but volatile love affair."
}
]
},
{
"p1": {
"planet": "Moon",
"full_degree": "43.0997128",
"sign": "Taurus",
"sign_no": 2,
"longitude": "13:5:59"
},
"p2": {
"planet": "Chiron",
"full_degree": "224.2841493",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "14:17:3"
},
"orb": 1.18,
"aspect": "Opposition",
"aspect_type": "Hard",
"reading": [
{
"title": "Emotional Turbulence",
"description": "When Person one's Moon is in opposition to Person two's Chiron, it may provoke emotional turbulence. Person one's emotional reactions and instincts may often wound or trigger Person two's deep-seated pains or hidden vulnerabilities."
},
{
"title": "Shared Healing",
"description": "Despite triggering each other's wounds, this aspect also creates potential for shared healing. If both Person one and Person two can acknowledge their emotional issues and work on healing them collectively, their bond could grow much stronger."
},
{
"title": "Depth of Understanding",
"description": "Although challenging, this opposition often leads to increased understanding between Person one and Person two. Person one’s emotional intuition coupled with Person two’s suffering can lead to deeper comprehension and empathy for each other's emotional states."
}
]
},
{
"p1": {
"planet": "Mercury",
"full_degree": "44.8177723",
"sign": "Taurus",
"sign_no": 2,
"longitude": "14:49:4"
},
"p2": {
"planet": "Chiron",
"full_degree": "224.2841493",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "14:17:3"
},
"orb": 0.53,
"aspect": "Opposition",
"aspect_type": "Hard",
"reading": [
{
"title": "Communication clashes",
"description": "Person one's Mercury opposition Person two's Chiron implies there might be differences how Person one communicates and Person two's perspective towards their own wounds and healing process. This might create tension in communication."
},
{
"title": "Understanding challenges",
"description": "Person one might inadvertently trigger Person two's deepest insecurities or past traumas, as Chiron represents wounds. This may lead to misunderstanding if Person one seems unsympathetic or unknowingly harsh in their approach."
},
{
"title": "Potential growth",
"description": "The tension between Person one's communication style and Person two's wounded areas could result in growth for both parties, provided they are willing to work through their issues. Person one might learn sensitivity while Person two may find healing."
}
]
}
]
}- To decipher the API response, identify the contrasting aspects by checking the "planet" fields in the "p1" and "p2" sections.
- Look at the "aspect" field to understand the nature of the contrast (e.g., "Opposition").
- Each aspect has a "reading" section with "title" and "description" pairs, providing insights on the impact of the aspect on the relationship.
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.