README

PHP SDK for the YEB Horoscope API. Daily, weekly, monthly horoscopes, tarot, Chinese zodiac and more.

Works standalone (plain PHP) or with Laravel (Facade + auto-discovery).

Requirements

PHP 8.1+
cURL extension
YEB API Key (free tier available)

Installation

composer require yebto/horoscope-api

Standalone Usage

use Yebto\HoroscopeAPI\HoroscopeAPI;

$api = new HoroscopeAPI(['key' => 'your-api-key']);
$result = $api->zodiacProfile('example');

Laravel Usage

Add your API key to .env:

YEB_KEY_ID=your-api-key

Use via Facade:

use HoroscopeAPI;

$result = HoroscopeAPI::zodiacProfile('example');

Or via dependency injection:

use Yebto\HoroscopeAPI\HoroscopeAPI;

public function handle(HoroscopeAPI $api)
{
    $result = $api->zodiacProfile('example');
}

Publish Config

php artisan vendor:publish --tag=yebto-horoscope-config

Available Methods

Method	Description
`zodiacProfile($sign)`	Get a zodiac sign profile
`dailyHoroscope($sign)`	Get a daily horoscope reading
`weeklyHoroscope($sign)`	Get a weekly horoscope reading
`monthlyHoroscope($sign)`	Get a monthly horoscope reading
`yearlyHoroscope($sign)`	Get a yearly horoscope reading
`compatibility($sign1, $sign2)`	Check zodiac compatibility between two signs
`tarotReading()`	Get a tarot card reading
`chineseZodiac($year)`	Get Chinese zodiac sign for a year
`chineseYearForecast($year)`	Get Chinese zodiac year forecast
`moonPhaseReport()`	Get a moon phase report
`biorhythm($birth_date)`	Calculate biorhythm cycles

All methods accept an optional $extra array parameter for additional API options.

Error Handling

use Yebto\ApiClient\Exceptions\ApiException;
use Yebto\ApiClient\Exceptions\AuthenticationException;
use Yebto\ApiClient\Exceptions\RateLimitException;

try {
    $result = $api->zodiacProfile('example');
} catch (AuthenticationException $e) {
    // Missing or invalid API key (401)
} catch (RateLimitException $e) {
    // Too many requests (429)
} catch (ApiException $e) {
    echo $e->getMessage();
    echo $e->getHttpCode();
}

yebto / horoscope-api

Maintainers

Package info

Statistics

Security