Zodiac Gift Guru API

Welcome to the Zodiac Gift Guru API, the ultimate tool for creating personalized and meaningful gift recommendations based on astrology. This API blends the art of thoughtful gifting with the science of the stars, providing users with tailored suggestions that resonate with the recipient's zodiac sign and current astrological influences.

Step by Step Zodiac Gift Guru API Postman Testing Integration

Supported Language Codes

Use the lan parameter in the request body to define your preferred response language.

Code	Language
en	English
hi	Hindi
pt	Portuguese
fr	French
de	German
ja	Japanese
tr	Turkish
ru	Russian
it	Italian
es	Spanish
nl	Dutch
pl	Polish

Guide:
These languages are supported by this API. You can use them by passing "lan" in the request body with the value of the language.

API Endpoint

POST https://astroapi-7.divineapi.com/api/v1/zodiac-gift-guru

Headers

Name	Type	Description
Authorization*	String	Your API Access Token. Example: `Bearer {token}`

Request Body

Name	Type	Description
api_key*	String	Your DivineAPI Key (available in your dashboard).
sign*	String	Zodiac sign (e.g., Aries).
h_day*	String	Day context (yesterday, today, tomorrow).
tzone*	Float	Timezone (e.g., 5.5). Refer to the Timezone List.
lan	String	Language code (default: `en`). How to update translator.

200: OK Fetched Zodiac Gift Guru Successfully

{
    "status": "success",
    "code": 200,
    "message": "Request was successful",
    "data": {
        "sign": "Aries",
        "date": "15 Jan 2025",
        "gift_suggestions": {
            "Augmented Reality Pet Toy": "This innovative toy engages pets in interactive play using augmented reality, perfect for keeping their minds active while responding to the adventurous Aries spirit and the curious energy brought by the Moon Sextile Uranus transit.",
            "Smart Indoor Garden Kit": "This tech-savvy garden kit allows a busy Aries to grow herbs and plants with ease, aligned with the nurturing vibe of Venus in Pisces and promotes mindfulness during the Full Moon phase.",
            "Portable Projector": "Ideal for an Aries who loves to host gatherings or enjoy solo movie nights, this portable projector brings bold experiences home, resonating with the dynamic energy of active Mars and the ongoing Jupiter retrograde encouraging unique perspectives."
        },
        "insight": "Aries, known for their bold, adventurous nature and love for new experiences, will appreciate gifts that offer excitement and interaction. The Moon Sextile Uranus transit boosts creativity and curiosity, making an Augmented Reality Pet Toy or a Portable Projector fitting for their love of new technologies. Moreover, a Smart Indoor Garden Kit aligns with the calming influence of Venus in Pisces and helps channel their abundant energy towards nurturing pursuits, harmonizing with the reflective Full Moon phase. These gifts support Aries' dynamic lifestyle and encourage exploration even during retrograde periods."
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location '
https://astroapi-7.divineapi.com/api/v1/zodiac-gift-guru
\
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'sign="Aries"' \
--form 'h_day="today"' \
--form 'tzone="5.5"' \
--form 'lan="en"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-7.divineapi.com/api/v1/zodiac-gift-guru',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'sign': 'Aries',
    'h_day': 'today',
    'tzone': '5.5',
    'lan': 'en'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery AJAX

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("sign", "Aries");
form.append("h_day", "today");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-7.divineapi.com/api/v1/zodiac-gift-guru",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth Token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python

import requests

url = "https://astroapi-7.divineapi.com/api/v1/zodiac-gift-guru"

payload = {'api_key': '{Your API Key}',
'sign': 'Aries',
'h_day': 'today',
'tzone': '5.5',
'lan': 'en'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.request("POST", url, headers=headers, data=payload,)

print(response.text)

Implementation Notes

Authentication:
Use a valid Bearer token in every API call to authenticate requests successfully.

Dynamic Recommendations:
The API takes into account zodiac transits, planetary aspects, and elemental balance to offer contextual and personalized gift ideas.

Customization:
Developers can modify input parameters (sign, h_day, lan) to fetch real-time gift insights for various zodiac signs and languages.

Integration Tip:
Combine gift recommendations with horoscope widgets or e-commerce platforms to enhance user engagement and conversion.