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 Sign Report" API request.
- Ensure the method is set to POST.
- Use this request URL: https://astroapi-4.divineapi.com/western-api/v1/general-sign-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",
"sign_name": "Gemini",
"report": "When the Sun is in Gemini, it means that at the time of your birth, the Sun was in the constellation of Gemini. This placement influences your core essence, ego, and identity.\n\nWith the Sun in Gemini, you have a natural curiosity and a thirst for knowledge. You possess a versatile and adaptable nature, and you thrive in environments that stimulate your mind. You are quick-witted, intelligent, and have a keen ability to grasp new concepts and information.\n\nYou have excellent communication skills and enjoy expressing yourself through words. Your natural charm and sociability make you adept at connecting with others and forming diverse relationships. You are often the life of the party and enjoy engaging in lively conversations and intellectual debates.\n\nYour mind is agile, and you have a gift for seeing multiple perspectives and understanding different viewpoints. You have a thirst for learning and may be drawn to various fields of study or have a wide range of interests. Your ability to absorb information quickly and make connections allows you to excel in fields such as writing, teaching, sales, or any profession that involves effective communication.\n\nYou possess a restless energy and may have a constant need for mental stimulation. Routine and monotony can be challenging for you, as you thrive on variety and change. You are adaptable and can easily shift gears and adapt to new situations or environments.\n\nIn relationships, you seek partners who can engage you intellectually and keep up with your lively mind. Mental compatibility is essential to you, and you appreciate partners who can match your wit and enjoy stimulating conversations. You may have a tendency to be flirtatious or have a fear of commitment, as your need for mental stimulation can sometimes overshadow emotional connections. It's important to find a balance between intellectual compatibility and emotional intimacy in your relationships.\n\nHowever, it's important to be mindful of a potential scattered energy or a tendency to become superficial in your pursuits. Your versatile nature may lead to a desire to experience everything, which can sometimes result in a lack of focus. Cultivating discipline and honing in on your priorities will help you make the most of your intellectual gifts and achieve long-term success.\n\nOverall, with the Sun in Gemini, you are a versatile and intellectually curious individual. Your quick mind, excellent communication skills, and adaptability contribute to your success in various areas of life. Embracing discipline and maintaining focus will help you channel your energy effectively and achieve your goals."
}
}
- The response provides a detailed astrological report. The "planet_name" and "sign_name" indicate the celestial body and its zodiac sign.
- The "report" contains a comprehensive description of how this placement influences personality traits and behaviors.
- This data is used to generate personalized horoscopes based on astrological positions 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.