Api

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

Unlock the full potential of your astrology platform with the EZ Horoscope Astrology API—a powerful tool designed to deliver daily, personalized astrological insights with professional accuracy. Our API calculates precise planetary positions, moon phases, retrogrades, aspects, and fixed star influences, transforming raw astronomical data into meaningful guidance your users will love.

Astrology Api

Seamlessly integrate both Western and Chinese astrology into your website or app, complete with zodiac-based horoscopes, planetary forecasts, compatibility reports, and celestial event tracking. Whether you’re building a horoscope website, mobile app, or spiritual content platform, our Astrology and Horoscope API gives you the flexibility, accuracy, and scalability to bring your cosmic vision to life.

With the EZ Horoscope Astrology API, developers can create a wide range of engaging astrology-based applications and interactive features. You can build daily horoscope apps, zodiac compatibility matchmakers, or AI-powered personal astrology assistants that deliver tailored readings on demand. The API also supports birth chart generation, transit tracking, and planetary event notifications, making it ideal for apps focused on self-discovery, relationship insights, and spiritual wellness. Furthermore, by combining astrology data with modern technologies such as voice AI, chatbots, or push notifications, you can craft immersive experiences that speak directly to your audience’s interests. Whether your goal is to enhance a lifestyle app, power a meditation platform, or develop an entirely new astrology product, the possibilities with our Astrology API are truly limitless.

🌌 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.