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 "Astro Nuggets" API request.
- Ensure the method is set to POST.
- Use this request URL: https://astroapi-7.divineapi.com/api/v1/astro-nuggets
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 | Value: <Your_API_Key>
- sign: “Aries” - Enter the zodiac sign.
- h_day: “today” - Enter the (yesterday, today, tomorrow)
- 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.
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:
{
"status": "success",
"code": 200,
"message": "Request was successful",
"data": {
"sign": "Aries",
"date": "21 Jan 2025",
"result": [
{
"astro_nugget_title": "Powerful Pluto and The Sun's Dance",
"fact_trivia": "When Pluto conjuncts the Sun, it’s like a cosmic power-up button, amplifying transformation and intensity.",
"fun_insight": "Embrace your inner superhero today; this celestial combo is all about reclaiming your power. Perfect time to dig deep and go after what you truly desire. Share if you feel that extra boost!"
},
{
"astro_nugget_title": "Airwaves of Love with Venus and Mercury",
"fact_trivia": "Venus sextile Mercury means love and communication are in sync—an ideal day for romantic chats or creative writing.",
"fun_insight": "Feeling chatty? It's not just caffeine! Let love-inspired words flow and connect heart-to-heart. Tag someone you want to talk sweet nothings with!"
},
{
"astro_nugget_title": "Jupiter and Moon’s Merry Trine",
"fact_trivia": "A trine between Jupiter and the Moon creates a harmonious vibe, bringing luck and emotional growth.",
"fun_insight": "Today’s the day to make a wish! With this cosmic blessing, your heart’s desires might just find a way to manifest. Share your dreams!"
},
{
"astro_nugget_title": "Ascendant Vibes Under Moonlight",
"fact_trivia": "The Ascendant’s conjunction with the Moon can bring out deeply personal emotions and your truest self.",
"fun_insight": "Feeling seen? You’re glowing! This alignment might expose your authentic side. Perfect moment for selfie reflection—what does your moonlit soul reveal?"
},
{
"astro_nugget_title": "Uranus and Mars: Sparks Fly",
"fact_trivia": "When Mars sextiles Uranus, expect unexpected bursts of energy and creative inspiration.",
"fun_insight": "Quirky ideas incoming! This dynamic duo encourages you to break the routine and embrace spontaneity. What’s your out-of-the-box move today? Share it!"
}
]
}
}
- Testing the Astro Nuggets API with Postman provides a simple and effective way to retrieve fun and engaging astrological insights.
- By following this guide, users can easily access bite-sized cosmic wisdom, analyze responses, and integrate the content into their platforms.
- Whether you're enhancing a blog, social media presence, or an astrology app, Postman offers a convenient way to explore and utilize the API's features for daily inspiration.
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. For a comprehensive guide on resolving errors and understanding their responses, refer to our Detailed Error Guide for API Integration.
8. Further Assistance
For additional support or inquiries, feel free to contact our customer service team at admin@divineapi.com.