How to Use the Horoscope API

Customer Process

Free Plan Access

The Free Trial plan is best for testing the Horoscope API, small widgets and personal websites.

• Feed included: Daily horoscope only
• Daily limit: 100 requests per day
• Monthly limit: 3,000 requests per month
• Minute limit: 20 requests per minute
• Activation: Automatic after email verification
• Format: RSS/XML or JSON

How Free Plan Works

1. Create a customer account.
2. Verify your email address.
3. Your Free API key activates automatically.
4. Login to your dashboard and copy your API key.
5. Use the daily horoscope API URL on your website or app.

Free Daily API URL:

Get Free API Key Customer Login

Secure API URL Format

Use this secured API URL with your private API key.

Parameters:

• type: daily, weekly, monthly, yearly
• sign: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces
• format: rss or json
• apikey: your private API key

PHP Integration Example

Use this sample PHP code to fetch the horoscope feed.

<?php
$url = 'https://www.findyourfate.com/api/horoscope.php?type=daily&sign=aries&format=json&apikey=YOUR_API_KEY';
$json = file_get_contents($url);
$data = json_decode($json, true);

if ($data && isset($data['ok']) && $data['ok']) {
    echo '<h2>' . htmlspecialchars($data['title']) . '</h2>';
    echo '<p>' . nl2br(htmlspecialchars($data['content'])) . '</p>';
}
?>

JSON API Example

JSON output is useful for apps, widgets and modern websites.

{
  "ok": true,
  "type": "daily",
  "sign": "Aries",
  "title": "Aries Horoscope",
  "content": "Your horoscope content appears here..."
}

API Usage Rules

• Every request must include a valid API key.
• Free plan supports daily horoscope feed only.
• Paid plans support daily, weekly, monthly and yearly feeds based on plan limits.
• API keys are domain/IP/usage-limit protected.
• Do not share your API key publicly.
• Requests without API keys are blocked automatically.

Paid Plans and Commercial API Access

Paid plans are for websites, mobile apps, widgets, publishers, newsletters and commercial horoscope integrations that need more feeds and higher request limits.

How Paid Activation Works

1. Create a customer account using your real email and website domain.
2. Verify your email address.
3. Login to your dashboard and choose a paid plan.
4. Complete PayPal subscription payment.
5. Your API key is activated automatically after PayPal confirmation.

White Label Access

Professional and Enterprise plans can use white-label access where FindYourFate branding can be removed from the API output when enabled for the account.

Security and Limits

• Every paid request must include a valid private API key.
• API keys can be locked to approved domains and optional server IPs.
• Rate limits are enforced per minute, per day and per month.
• Suspended, expired, shared or abused keys are blocked automatically.
• Requests without API keys are blocked before reaching the API system.

Example Paid Feed URLs

Daily:

Weekly:

Monthly:

Yearly:

Create Account Login & Upgrade Plan