Api

Create your own custom astrology and horoscope website or app using our api.

Our powerful Astrology and Horoscope API delivers daily, personalized astrological insights based on precise planetary positions, moon phases, retrogrades, aspects, and fixed star influences. Seamlessly integrate Western and Chinese astrology content into your website or app—including zodiac-based horoscopes, planetary forecasts, and celestial event tracking. Ideal for horoscope platforms, apps, and spiritual content creators.


🌌 EZ Horoscope & Astrology API – Full PHP Usage Guide

Base URL:
https://api.ezhoroscope.com

All API requests must include your API key as a query parameter (your api key is your professional plugin subscription license id, use “test”, to try things out):

?apikey=your_api_key_here

🔮 Western Horoscopes

🗓️ Get Daily Horoscope

$url = "https://api.ezhoroscope.com/api/horoscope/western-daily?zodiacSign=leo&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo $data['HoroscopeText'];

📅 Get Weekly Horoscope

$url = "https://api.ezhoroscope.com/api/horoscope/western-weekly?zodiacSign=leo&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo $data['HoroscopeText'];

🧩 Get a Specific Section

$url = "https://api.ezhoroscope.com/api/horoscope/western-section?zodiacSign=leo&content=guidance&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo $data['sectionHtml'];

🐉 Chinese Horoscopes

🧠 Get Zodiac Sign + Element

$url = "https://api.ezhoroscope.com/api/horoscope/chinese-zodiac?birthDate=1990-07-15&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo "Animal: " . $data['Animal'] . ", Element: " . $data['Element'];

📜 Get Daily Horoscope

$url = "https://api.ezhoroscope.com/api/horoscope/chinese?birthDate=1990-07-15&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo $data['HoroscopeText'];

🎯 Get Daily Insight

$url = "https://api.ezhoroscope.com/api/horoscope/chinese-daily-insight?birthDate=1990-07-15&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo "Lucky Numbers: " . implode(', ', $data['LuckyNumbers']);

🍀 Lucky Numbers (Birthdate)

$url = "https://api.ezhoroscope.com/api/horoscope/chinese-lucky-numbers-for-birthdate?birthDate=1990-07-15&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo "Lucky Numbers: " . implode(', ', $data['LuckyNumbers']);

🗓️ Lucky Numbers (Target Date)

$url = "https://api.ezhoroscope.com/api/horoscope/chinese-lucky-numbers-for-date?birthDate=1990-07-15&date=2025-04-10&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo "Lucky Numbers: " . implode(', ', $data['LuckyNumbers']);

🎨 Lucky Colors

$url = "https://api.ezhoroscope.com/api/horoscope/chinese-lucky-colors?date=2025-04-10&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo "Lucky Colors: " . implode(', ', $data['LuckyColors']);

🧭 Lucky Directions

$url = "https://api.ezhoroscope.com/api/horoscope/chinese-lucky-directions?birthDate=1990-07-15&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo "Lucky Directions: " . implode(', ', $data['LuckyDirections']);

🌙 Moon & Astrology

🌔 Get Moon Phase

$url = "https://api.ezhoroscope.com/api/horoscope/moon-phase?date=2025-04-10&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo "Moon Phase: " . $data['MoonPhase'];

🌕 Get Moon Type (e.g. Supermoon)

$url = "https://api.ezhoroscope.com/api/horoscope/moon-type?date=2025-04-10&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo "Moon Type: " . $data;

🪐 Planetary Insights

🪐 Planetary Positions

$url = "https://api.ezhoroscope.com/api/horoscope/planetary-positions?date=2025-04-10&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
foreach ($data as $planet => $sign) {
    echo "$planet is in $sign<br>";
}

🧭 Planetary Positions (Detailed)

$url = "https://api.ezhoroscope.com/api/horoscope/planetary-positions-detailed?date=2025-04-10&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
foreach ($data['Positions'] as $planet) {
    echo "{$planet['Name']}: {$planet['Sign']} at {$planet['Degree']}°<br>";
}

🔭 Planetary Aspects

$url = "https://api.ezhoroscope.com/api/horoscope/planetary-aspects?date=2025-04-10&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
foreach ($data['Aspects'] as $aspect) {
    echo $aspect . "<br>";
}

🌀 Retrogrades

$url = "https://api.ezhoroscope.com/api/horoscope/retrogrades?date=2025-04-10&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
foreach ($data['Retrogrades'] as $planet) {
    echo "$planet is retrograde<br>";
}

🌟 Fixed Star Influences

$url = "https://api.ezhoroscope.com/api/horoscope/fixed-star-influences?date=2025-04-10&apikey=your_api_key";
$response = file_get_contents($url);
$data = json_decode($response, true);
foreach ($data['Influences'] as $influence) {
    echo $influence . "<br>";
}

✅ Final Notes

  • Replace your_api_key with your actual key from your Freemius account.
  • All API responses are in JSON format.
  • You can test endpoints in your browser, Postman, or from your PHP-based website or plugin.