Composite Friendship

Uncover intricate social dynamics with our Composite Friendship API, offering insights into planetary compatibility and interpersonal relationships through the lens of Indian Astrology. This API generates detailed tables describing the natural, temporary, and five-fold planetary friendships to reveal astrological harmony or conflict among planets.

Step-by-Step Composite Friendship API Postman Testing Integration

View Integration Guide

Supported Language Codes

Support Article URL: Translating Indian Vedic APIs into Different Languages

Code	Language
en	English
hi	Hindi
bn	Bengali
ma	Marathi
tm	Tamil
tl	Telugu
ml	Malayalam
kn	Kannada

Guide:
These languages are supported by this API. You can specify the language by passing the "lan" parameter in the request body with the corresponding language code. The default language is English (en).

API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v1/composite-friendship

This endpoint returns a Composite Friendship Table based on planetary relationships.

Headers

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

Request Body

Name	Type	Description
api_key	String	Your API key
full_name	String	Full name, e.g., Rahul Kumar
day	Integer	Date of birth, e.g., 24
month	Integer	Month of birth, e.g., 05
year	Integer	Year of birth, e.g., 2023
hour	Integer	Hour, e.g., 14
min	Integer	Minute, e.g., 40
sec	Integer	Second, e.g., 43
gender	String	Gender, e.g., male
place	String	Place of birth, e.g., New Delhi
lat	Float	Latitude, e.g., 28.7041
lon	Float	Longitude, e.g., 77.1025
tzone	Float	Time zone, e.g., 5.5 (Timezone Reference Guide)
lan	String	Language code as per the supported language table. Default is ‘en’.

Example Successful Response (200: OK)

{
    "success": 1,
    "data": {
        "natural_friendship": {
            "Sun": {
                "Sun": "-",
                "Moon": "Friend",
                "Mars": "Friend",
                "Mercury": "Neutral",
                "Jupiter": "Friend",
                "Venus": "Enemy",
                "Saturn": "Enemy"
            },
            "Moon": {
                "Sun": "Friend",
                "Moon": "-",
                "Mars": "Neutral",
                "Mercury": "Friend",
                "Jupiter": "Neutral",
                "Venus": "Neutral",
                "Saturn": "Neutral"
            },
            "Mars": {
                "Sun": "Friend",
                "Moon": "Friend",
                "Mars": "-",
                "Mercury": "Enemy",
                "Jupiter": "Friend",
                "Venus": "Neutral",
                "Saturn": "Neutral"
            },
            "Mercury": {
                "Sun": "Friend",
                "Moon": "Enemy",
                "Mars": "Neutral",
                "Mercury": "-",
                "Jupiter": "Neutral",
                "Venus": "Friend",
                "Saturn": "Neutral"
            },
            "Jupiter": {
                "Sun": "Friend",
                "Moon": "Friend",
                "Mars": "Friend",
                "Mercury": "Enemy",
                "Jupiter": "-",
                "Venus": "Enemy",
                "Saturn": "Neutral"
            },
            "Venus": {
                "Sun": "Enemy",
                "Moon": "Enemy",
                "Mars": "Neutral",
                "Mercury": "Friend",
                "Jupiter": "Neutral",
                "Venus": "-",
                "Saturn": "Friend"
            },
            "Saturn": {
                "Sun": "Enemy",
                "Moon": "Enemy",
                "Mars": "Enemy",
                "Mercury": "Friend",
                "Jupiter": "Neutral",
                "Venus": "Friend",
                "Saturn": "-"
            }
        },
        "temporary_friendship": {
            "Sun": {
                "Sun": "-",
                "Moon": "Friend",
                "Mercury": "Friend",
                "Venus": "Friend",
                "Mars": "Friend",
                "Jupiter": "Friend",
                "Saturn": "Friend"
            },
            "Moon": {
                "Sun": "Friend",
                "Moon": "-",
                "Mercury": "Friend",
                "Venus": "Friend",
                "Mars": "Enemy",
                "Jupiter": "Friend",
                "Saturn": "Enemy"
            },
            "Mercury": {
                "Sun": "Friend",
                "Moon": "Friend",
                "Mercury": "-",
                "Venus": "Friend",
                "Mars": "Friend",
                "Jupiter": "Enemy",
                "Saturn": "Friend"
            },
            "Venus": {
                "Sun": "Friend",
                "Moon": "Friend",
                "Mercury": "Friend",
                "Venus": "-",
                "Mars": "Friend",
                "Jupiter": "Friend",
                "Saturn": "Enemy"
            },
            "Mars": {
                "Sun": "Friend",
                "Moon": "Enemy",
                "Mercury": "Friend",
                "Venus": "Friend",
                "Mars": "-",
                "Jupiter": "Friend",
                "Saturn": "Enemy"
            },
            "Jupiter": {
                "Sun": "Friend",
                "Moon": "Friend",
                "Mercury": "Enemy",
                "Venus": "Friend",
                "Mars": "Friend",
                "Jupiter": "-",
                "Saturn": "Friend"
            },
            "Saturn": {
                "Sun": "Friend",
                "Moon": "Enemy",
                "Mercury": "Friend",
                "Venus": "Enemy",
                "Mars": "Enemy",
                "Jupiter": "Friend",
                "Saturn": "-"
            }
        },
        "five_fold_friendship": {
            "Sun": {
                "Sun": "-",
                "Moon": "Best Friend",
                "Mercury": "Friend",
                "Venus": "Neutral",
                "Mars": "Best Friend",
                "Jupiter": "Best Friend",
                "Saturn": "Neutral"
            },
            "Moon": {
                "Sun": "Best Friend",
                "Moon": "-",
                "Mercury": "Best Friend",
                "Venus": "Friend",
                "Mars": "Enemy",
                "Jupiter": "Friend",
                "Saturn": "Enemy"
            },
            "Mercury": {
                "Sun": "Best Friend",
                "Moon": "Neutral",
                "Mercury": "-",
                "Venus": "Best Friend",
                "Mars": "Friend",
                "Jupiter": "Enemy",
                "Saturn": "Friend"
            },
            "Venus": {
                "Sun": "Neutral",
                "Moon": "Neutral",
                "Mercury": "Best Friend",
                "Venus": "-",
                "Mars": "Friend",
                "Jupiter": "Friend",
                "Saturn": "Neutral"
            },
            "Mars": {
                "Sun": "Best Friend",
                "Moon": "Neutral",
                "Mercury": "Neutral",
                "Venus": "Friend",
                "Mars": "-",
                "Jupiter": "Best Friend",
                "Saturn": "Enemy"
            },
            "Jupiter": {
                "Sun": "Best Friend",
                "Moon": "Best Friend",
                "Mercury": "Bitter Enemy",
                "Venus": "Neutral",
                "Mars": "Best Friend",
                "Jupiter": "-",
                "Saturn": "Friend"
            },
            "Saturn": {
                "Sun": "Neutral",
                "Moon": "Bitter Enemy",
                "Mercury": "Best Friend",
                "Venus": "Neutral",
                "Mars": "Bitter Enemy",
                "Jupiter": "Friend",
                "Saturn": "-"
            }
        }
    }
}

Example Integrations

Below are examples of how you might call this API using different programming languages and environments.

cURL

curl -X POST \
  https://astroapi-3.divineapi.com/indian-api/v1/composite-friendship \
  -H 'authorization: Bearer {Your API Access Token}' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -F api_key={Your API Key}
  -F full_name='Rahul Kumar' \
  -F place='New Delhi, India' \
  -F gender='male' \
  -F day=24 \
  -F month=05 \
  -F year=2023 \
  -F hour=14 \
  -F min=40 \
  -F sec=43 \
  -F lat=28.7041 \
  -F lon=77.1025 \
  -F tzone=5.5 \

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v1/composite-friendship',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'full_name': 'Test',
    'day': '24',
    'month': '05',
    'year': '2023',
    'hour': '14',
    'min': '40',
    'sec': '43',
    'gender': 'male',
    'place': 'New Delhi',
    'lat': '28.7041',
    'lon': '77.1025',
    '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("full_name", "Test");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v1/composite-friendship",
  "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-3.divineapi.com/indian-api/v1/composite-friendship"

payload = {'api_key': '{Your API Key}',
'full_name': 'Test',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi',                                                  
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en'}

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

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

print(response.text)

Summary

The Composite Friendship API provides detailed planetary relationship insights in the form of three friendship tables:

Natural Friendship: Indicates the inherent relationship between planets based on traditional astrology.

Temporary Friendship: Represents situational planetary relationships based on their house positions in the birth chart.

Five-Fold Friendship: Combines both natural and temporary relationships to determine the final degree of friendship or enmity.

This API helps astrologers and developers integrate advanced relationship analytics into astrology platforms, matchmaking systems, and astrological mobile applications.