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
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.