Horoscope by Sign API

Horoscope for one sign

GET/v1/horoscope/{sign}

1 credit · Secret or publishable key · getHoroscope

Parameters

Name	In	Type	Notes
`sign` required	path	string	one of `aries`, `taurus`, `gemini`, `cancer`, `leo`, `virgo`, `libra`, `scorpio`, `sagittarius`, `capricorn`, `aquarius`, `pisces`
`period`	query	string	one of `daily`, `weekly`, `monthly`, `yearly` · default `"daily"`
`lang`	query	string	one of `en`, `hi` · default `"en"`
`date`	query	string (date)

Response

JSON { data, meta, warnings }, where data is:

sign string required
sign_label string required
period string required
one of daily, weekly, monthly, yearly
date string (date) required
e.g. "1990-08-13"
reading string required
scores object required
- love integer required
  ≥ 0 · ≤ 100
- career integer required
  ≥ 0 · ≤ 100
- health integer required
  ≥ 0 · ≤ 100
- money integer required
  ≥ 0 · ≤ 100
score_notes object required
- love string required
- career string required
- health string required
- money string required
ruler string required
element string required
lucky object required
- color string required
- number string required
- day string required
- gem string required
- time string required
- mood string required
transits array of object required
- planet string required
- sign string required
- house integer required
  ≥ 1 · ≤ 12
- tone string required
- retrograde boolean required
hindi object
With lang=hi only: the engine's whole Hindi reading (name, reading, the four areas, the lucky colour, number and day).
- name string required
- reading string required
- areas object required
  Fields
  - career string required
  - love string required
  - health string required
  - money string required
- lucky object required
  Fields
  - color string required
  - number string required
  - day string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl 'https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'

Node.js

const res = await fetch("https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 2,019 characters

{
  "data": {
    "sign": "leo",
    "sign_label": "सिंह",
    "period": "weekly",
    "date": "2026-10-02",
    "reading": "कार्यक्षेत्र में मिश्रित स्थिति - सोच-समझकर निर्णय लें। प्रेम जीवन अनुकूल रहेगा, साथी से तालमेल अच्छा रहेगा। स्वास्थ्य में उतार-चढ़ाव - खानपान का ध्यान रखें। आर्थिक स्थिति स्थिर रहेगी।",
    "scores": {
      "love": 58,
      "career": 39,
      "health": 43,
      "money": 47
    },
    "score_notes": {
      "love": "Favourable",
      "career": "Mixed",
      "health": "Mixed",
      "money": "Steady"
    },
    "ruler": "sun",
    "element": "fire",
    "lucky": {
      "color": "Gold",
      "number": "1",
      "day": "Sunday",
      "gem": "Ruby",
      "time": "3-5 PM",
      "mood": "Patient"
    },
    "transits": [
      {
        "planet": "venus",
        "sign": "libra",
        "house": 3,
        "tone": "benefic",
        "retrograde": false
      },
      {
        "planet": "sun",
        "sign": "virgo",
        "house": 2,
        "tone": "challenging",
        "retrograde": false
      },
      {
        "planet": "mercury",
        "sign": "libra",
        "house": 3,
        "tone": "challenging",
        "retrograde": false
      },
      {
        "planet": "jupiter",
        "sign": "cancer",
        "house": 12,
        "tone": "challenging",
        "retrograde": false
      }
    ],
    "hindi": {
      "name": "सिंह",
      "reading": "कार्यक्षेत्र में मिश्रित स्थिति - सोच-समझकर निर्णय लें। प्रेम जीवन अनुकूल रहेगा, साथी से तालमेल अच्छा रहेगा। स्वास्थ्य में उतार-चढ़ाव - खानपान का ध्यान रखें। आर्थिक स्थिति स्थिर रहेगी।",
      "areas": {
        "career": "मिश्रित",
        "love": "अनुकूल",
        "health": "मिश्रित",
        "money": "स्थिर"
      },
      "lucky": {
        "color": "सुनहरा",
        "number": "1",
        "day": "रविवार"
      }
    }
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

sign (path)

period (query)

lang (query)

date (query)

Horoscope by Sign API

Parameters

Response

Example request

Example response

More in Horoscopes