Beauty by the Stars API

Welcome to the Beauty by the Stars API, a powerful tool for delivering personalized beauty recommendations inspired by astrology. This API is designed to combine the charm of zodiac traits with the influence of current astrological events, offering tailored beauty insights to enhance user experiences on your platform.

Step by Step Beauty by the Stars 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/beauty-by-the-stars

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 Beauty by the Stars Successfully

{
    "status": "success",
    "code": 200,
    "message": "Request was successful",
    "data": {
        "sign": "Aries",
        "date": "15 Jan 2025",
        "beauty_picks": {
            "Red Lipstick": "Bold and confident, embodies Aries' fiery spirit.",
            "Illuminating Highlighter": "Adds a radiant glow, highlighting Aries' energetic aura.",
            "Cooling Face Mask": "Soothes and calms, balancing Aries' passionate nature."
        },
        "beauty_insight": "With the Full Moon illuminating transformation and retrograde Mars inspiring reflection, Aries faces a period of introspection. Bold red lipstick channels Aries' fearless determination, empowering self-expression. An illuminating highlighter enhances their natural dynamism, allowing their vibrant energy to shine even amidst introspective times. The cooling face mask provides a calming counterbalance to fiery impulses, promoting tranquility and self-care. These beauty products align with Aries' innate characteristics and the current cosmic energies, offering both empowerment and harmony during this astrological phase. Embrace the balance of boldness and calm to navigate the celestial influences with grace and courage."
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location '
https://astroapi-7.divineapi.com/api/v1/beauty-by-the-stars
\
--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/beauty-by-the-stars',
  '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/beauty-by-the-stars",
  "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/beauty-by-the-stars"

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:
Ensure every request includes a valid Bearer token to authenticate the API call successfully.

Dynamic Beauty Insights:
The API combines zodiac attributes and live planetary influences to suggest beauty products uniquely tailored for each sign.

Customization Options:
You can dynamically alter parameters like sign, h_day, and lan to generate personalized insights in multiple languages.

Integration Idea:
Pair this API with lifestyle or e-commerce platforms to offer cosmic beauty suggestions, enhancing engagement and personalization.