1. 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 "General House Report" API request.
- Ensure the method is set to POST.
- Use this request URL: https://astroapi-4.divineapi.com/western-api/v1/general-house-report/:planet
Planet Allowed
sun: For Sun Data
moon: For Moon Data
mars: For Mars Data
mercury: For Mercury Data
venus: For Venus Data
jupiter: For Jupiter Data
saturn: For Saturn Data
northnode: For North node Data
southnode: For South node Data
uranus: For Uranus Data
neptune: For Neptune Data
pluto: For Pluto Data
mc: For MC (Midheaven) Data
chiron: For Chiron Data
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.
- full_name: “Your name” - Enter name.
- day: “24” - Enter the date of birth.
- month: “05” - Enter the month of birth.
- year: "2023" - The year of interest.
- hour: “14” - Enter the hour.
- min: “40” - Enter the minute.
- sec: “43” - Enter the second.
- gender: “male” - Enter the gender.
- place: “New Delhi” - The name of the city.
- lat: "28.6139" - Latitude for location-specific details.
- lon: "77.2090" - Longitude for accurate location insights.
- 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": {
"planet_name": "Sun",
"house": 8,
"report": "When the Sun is in the eighth house of a person's birth chart, it significantly influences their transformative experiences, shared resources, and deep psychological aspects.\n\nIntense and Transformative Experiences: With the Sun in the eighth house, you are likely to experience intense and transformative events throughout your life. These experiences may bring about significant changes, personal growth, and a deep understanding of life's mysteries.\n\nDesire for Self-Discovery: You have a strong desire for self-discovery and a fascination with the hidden aspects of life. You are drawn to uncovering the deeper truths and meanings behind experiences and seek personal transformation through this exploration.\n\nPower Dynamics in Relationships: The placement of the Sun in the eighth house can influence power dynamics within your relationships. You may have a strong need to assert your individuality and maintain a sense of personal power. It's important to find a balance between your personal desires and the needs of your partnerships.\n\nIntuition and Psychic Abilities: The Sun in the eighth house enhances your intuitive and psychic abilities. You have a natural inclination to understand the deeper motivations and emotions of others. Trusting your intuition can help you navigate complex relationship dynamics.\n\nShared Finances and Resources: The eighth house is associated with shared resources, including financial matters and intimacy. With the Sun in this house, you may have a focus on managing joint finances and investments with your partners. There may be a need for transparency and trust in financial matters.\n\nDeep Emotional Connections: Your relationships tend to be characterized by deep emotional connections and intense bonds. You may be drawn to partners who have a transformative effect on your life and help you explore the depths of your emotions.\n\nPsychological Insight and Healing: The Sun in the eighth house grants you psychological insight and the potential for deep healing. You may be interested in psychotherapy, self-analysis, or other forms of self-exploration to better understand your inner self and heal past wounds.\n\nEmbracing Change and Letting Go: The eighth house represents transformation and letting go of the old to make way for the new. With the Sun in this house, you are encouraged to embrace change and release attachments that no longer serve you. This process can lead to personal growth and empowerment.\n\nInterest in Mysticism and Occult Sciences: The placement of the Sun in the eighth house may spark an interest in mysticism, occult sciences, and metaphysical subjects. You may be drawn to exploring spiritual practices, such as astrology, tarot, or energy healing, to deepen your understanding of life's mysteries.\n\nFacing the Shadow Self: The eighth house is associated with the shadow self, and with the Sun in this house, you are encouraged to confront and integrate your shadow aspects. By acknowledging and accepting all parts of yourself, you can experience greater wholeness and authenticity in your relationships."
}
}
- The response provides an astrological interpretation.
- The "planet_name" and "house" indicate the celestial body and its house placement in a birth chart.
- The "report" contains a detailed description of how this placement affects an individual's experiences and personality traits.
- This information is used to generate personalized astrological insights based on house placements at birth.
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.