Gemstone Suggestion

The Gemstone Suggestion API provides personalized gemstone recommendations based on astrological and numerological principles. It suggests gemstones that align with an individual’s unique vibrations and planetary influences. The API also provides details such as the most suitable finger, day, and metal for wearing the gemstone. This helps users attract prosperity, health, and balance through harmonized energy fields.

Step by Step Gemstone Suggestion API Postman Testing Integration

Endpoint

POST https://astroapi-7.divineapi.com/numerology/v1/gemstones

Returns Gemstone Suggestion in response.

Headers

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

Request Body

Name	Type	Description
api_key*	String	Your API key from the DivineAPI dashboard.
day*	Integer	Date of birth. Example: `24`.
month*	Integer	Month of birth. Example: `05`.
year*	Integer	Year of birth. Example: `2023`.
fname*	String	First name. Example: `Rahul`.
lname	String	Last name. Example: `Kumar`.
lan	String	Response language. Default: `en` (supports `en`, `hi`).

200: OK Numbers Fetched Successfully

{
    "status": "success",
    "code": 200,
    "message": "Request was successful",
    "data": {
        "gem_recommendation_one": {
            "name": "Emerald (Panna)",
            "icon": "https://astroapi-7.divineapi.com/public/gemstone/Emerald.png"
        },
        "gem_recommendation_one_finger": {
            "name": "Little",
            "icon": "https://astroapi-7.divineapi.com/public/gemstone/Little.png"
        },
        "gem_recommendation_one_best_day_wearing": {
            "name": "Wednesday",
            "icon": "https://astroapi-7.divineapi.com/public/gemstone/Wednesday.png"
        },
        "gem_recommendation_one_metal_suggesion": {
            "name": "Gold",
            "icon": "https://astroapi-7.divineapi.com/public/gemstone/Gold.png"
        },
        "gem_recommendation_two": {
            "name": "Emerald (Panna)",
            "icon": "https://astroapi-7.divineapi.com/public/gemstone/emerald.png"
        },
        "gem_recommendation_two_finger": {
            "name": "Little",
            "icon": "https://astroapi-7.divineapi.com/public/gemstone/Little.png"
        },
        "gem_recommendation_two_best_day_wearing": {
            "name": "Wednesday",
            "icon": "https://astroapi-7.divineapi.com/public/gemstone/Wednesday.png"
        },
        "gem_recommendation_two_metal_suggesion": {
            "name": "Gold",
            "icon": "https://astroapi-7.divineapi.com/public/gemstone/Gold.png"
        }
    }
}

Example Implementations

cURL

curl --location 'https://astroapi-7.divineapi.com/numerology/v1/gemstones' \
--header 'Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'fname="Rahul"' \
--form 'lname="Kumar"' \
--form 'lan="en"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': https://astroapi-7.divineapi.com/numerology/v1/gemstones,
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'day': '24',
    'month': '05',
    'year': '2023',
    'fname': 'Rahul',
    'lname': 'Kumar',
    '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("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("fname", "Rahul");
form.append("lname", "Kumar");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-7.divineapi.com/numerology/v1/gemstones",
  "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/numerology/v1/gemstones"

payload = {'api_key': '{Your API Key}',
'day': '24',
'month': '05',
'year': '2023',
'fname': 'Rahul',
'lname': 'Kumar',
'lan': 'en'}

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

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

print(response.text)

Implementation Notes

Authentication Required:
Use a valid Bearer token in the Authorization header for successful API access.

Localized Output:
Use the lan parameter to retrieve gemstone names and descriptions in multiple languages (English, Hindi supported).

Display Integration:
You can utilize the gemstone image URLs (from icon) to show gemstone visuals in your app interface.

Practical Implementation:
Ideal for astrology dashboards, e-commerce jewelry platforms, and numerology-based wellness reports to offer gemstone consultation digitally.