Weekly Transit

Explore our Transit API's Weekly Transit feature, offering weekly insights on planetary movements in relation to natal charts, spotlighting key astrological trends and their potential weekly impacts.

Allowed Transit Planets

Use one of the following values in transit_planet.

Step by Step Weekly Transit API Postman Testing Integration

Testing Guide URL

Supported Language Codes

Support Article URL: Translating a Natal API into a Different Language

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

House System Codes

Support Article URL: How to Change the House System Code in Natal Astrology

Note: The default house system used is P – Placidus.

API Endpoint

POST https://astroapi-4.divineapi.com/western-api/v1/transit/weekly

Response: Returns Weekly Transit in response.

Headers

Request Body

200: OK Weekly Transit fetched successfully

{
    "success": 1,
    "data": {
        "start_date": "2024-04-21",
        "end_date": "2024-04-27",
        "natal_ascendant": "Libra",
        "transit_response": [
            {
                "transit_planet": "Moon",
                "natal_planet": "Ascendant",
                "aspect": "Conjunction",
                "transit_time": "2024-04-21 20:13:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Sun",
                "aspect": "Trine",
                "transit_time": "2024-04-21 14:39:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Mercury",
                "aspect": "Quincunx",
                "transit_time": "2024-04-22 02:54:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Venus",
                "aspect": "Quincunx",
                "transit_time": "2024-04-27 16:49:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Mars",
                "aspect": "Trine",
                "transit_time": "2024-04-26 11:11:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Jupiter",
                "aspect": "Conjunction",
                "transit_time": "2024-04-24 00:15:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Saturn",
                "aspect": "Trine",
                "transit_time": "2024-04-24 10:05:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Uranus",
                "aspect": "Conjunction",
                "transit_time": "2024-04-25 11:30:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Neptune",
                "aspect": "Trine",
                "transit_time": "2024-04-26 01:59:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Pluto",
                "aspect": "Square",
                "transit_time": "2024-04-23 21:19:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "North node",
                "aspect": "Semisextile",
                "transit_time": "2024-04-26 12:05:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "South node",
                "aspect": "Semisextile",
                "transit_time": "2024-04-26 12:05:00"
            }
        ]
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-4.divineapi.com/western-api/v1/transit/weekly' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Test"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"' \
--form 'transit_planet="Moon"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-4.divineapi.com/western-api/v1/transit/weekly',
  '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',
    'transit_planet': 'Moon'
  }
};
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");
form.append("transit_planet", "Moon");

var settings = {
  "url": "https://astroapi-4.divineapi.com/western-api/v1/transit/weekly",
  "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-4.divineapi.com/western-api/v1/transit/weekly"

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',
'transit_planet': 'Moon'}

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

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

print(response.text)

Use Authorization: Bearer {Your Auth Token} and {Your API Key} securely; never expose them in client-side code.

Provide date, time, and coordinates in correct numeric formats; use decimal timezone values (e.g., 5.5).

Check HTTP status codes, log responses, and handle 4xx/5xx errors gracefully.

Defaults are lan=en and house_system=P; test via Postman first and always use HTTPS for secure communication.