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 "Yearly Prediction" API request.
- Ensure the method is set to POST.
- Use this request URL: https://astroapi-7.divineapi.com/numerology/v1/yearly-prediction
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>
- day: “24” - Enter the day.
- month: “05” - Enter the month.
- year: “2023” - Enter the year.
- fname: “Rahul” - Enter the first name.
- lname: "kumar" - Enter the last name.
- lan : “en” - Enter the language ex. (en/hi).
- 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:
{
{
"success": 1,
"data": {
"first": {
"year": 2025,
"result": "Most crucial to sustain your life is patience and endurance. It is going to be a slow-moving year. You already know that good things in life take time, perhaps much longer than you think. This year you will experience it more than ever. Every plan will come to a halt. There is not much that you can do to eliminate this stagnation. You have to keep your hopes alive; your dreams will take time to materialize. But you cannot afford to stop dreaming. Of course, nothing will go as planned, and it will disappoint you to your core. But you must not let it overwhelm you.\r\n\r\n You still have your weapons of hard work and talent. Your strongest armor is your creativity. New ideas will keep flowing through you. But if you are aiming to execute those ideas, it is advised that you keep those plans at bay for the time being. Not because you will fail, but the results will leave you disheartened. In a year full of hurdles and struggles, this added stagnancy is the last thing you need. It will be a slow and steady year for you and your endeavors. You are urged to maintain calm to keep frustration away. \r\n\r\nGetting frustrated will make the process even slower. You must try to be responsible. Trust the process. The hard work done this year will bring fruitful results in the coming years. Understandably, you want to be as productive as possible, but it will not go as per your desire. This year, patience is the key. Do not stress out over failed attempts. For those of you who are involved in sports and other recreation, this year is for you. It is the perfect year to take out time for your family and work on your relationships. However, nothing new will materialize in your life this year, so it is better to take care of the things you have in hand and be grateful. The year's end is likely to be great for you.\r\n\r\n It will bring new hope into your life, and several aspects will change in the next few years. If you are unmarried then this year you have a chance to get married. It is also a great year for a writer. You will have an ample amount of time to think. People involved in industry will also do well. If you work as a media person, you will have a nice year nonetheless."
},
"second": {
"year": 2026,
"result": "This is a year of hard work and struggle. Work and career-related things will bombard you and you will hardly find time for recreation and replenishment. There will be no time for fun and frolic with friends. Travel is not likely to happen this year. You should take long breaks and make travel plans, but you will be unable to take the time for their execution. So, traveling and adventure are not likely to happen. \r\n\r\nIf you want to take full advantage of this year, you need to sort your objectives and prospects as soon as possible. Your career plans and goals need more effort and hard work to prevail. This year is all about the steps you put in and the sweat you shed to attain your goals. Meanwhile, try to make new friends and commence some new line of work. New friends will give you a new perspective and a new job will take you to a newer altitude. This is also a year of completing all the old and pending goals that you have been postponing for years. \r\n\r\nThis year will provide you time to ponder about desires you left behind. Now it is time to drag them back into your life. This year will be perfect for starting a family. You are likely to become a parent, and a new kind of adventure will bless your family. If you are a creative person, then it is your time to unleash your creativity. Be as inventive and creative as you want. Your art will see a boost this year."
}
}- The Yearly Prediction API provides detailed year-by-year astrological forecasts, offering insights into key events, challenges, and opportunities.
- It helps users plan their careers, relationships, finances, and personal growth with tailored predictions for each year.
- Perfect for astrology platforms to deliver personalized yearly guidance to their audience.
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.