Horoscope API Integration Guide 2025

Why Add Horoscopes to Your App?

Horoscope features drive daily active users. Users check horoscopes every morning, creating sticky engagement. Apps with horoscope features see 40% higher DAU than those without.

Horoscope API Endpoints

Daily Horoscope

GET https://api.vedika.io/v1/horoscope/daily/aries

Response:
{
  "sign": "aries",
  "date": "2025-12-22",
  "prediction": {
    "overall": { "text": "Today brings exciting opportunities...", "sentiment": "positive", "score": 82 },
    "love": { "text": "Romance is in the air...", "sentiment": "positive", "score": 88 },
    "career": { "text": "A colleague may approach you...", "sentiment": "neutral", "score": 72 },
    "health": { "text": "Focus on hydration...", "sentiment": "neutral", "score": 68 },
    "finance": { "text": "Avoid impulsive purchases...", "sentiment": "challenging", "score": 55 }
  },
  "luckyNumbers": [7, 14, 22],
  "luckyColor": "Red",
  "compatibility": "Leo",
  "mood": "Energetic"
}

Personalized AI Horoscope

For deeper personalization, use the AI chatbot with birth details:

POST https://api.vedika.io/v1/chat
{
  "message": "What does today hold for me?",
  "birthDetails": {
    "dateOfBirth": "1990-04-15",
    "timeOfBirth": "10:30:00",
    "placeOfBirth": "New York, USA"
  }
}

Code Examples

React Component

import { useState, useEffect } from 'react';

function DailyHoroscope({ sign }) {
  const [horoscope, setHoroscope] = useState(null);

  useEffect(() => {
    fetch(`https://api.vedika.io/v1/horoscope/daily/${sign}`, {
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
    })
    .then(res => res.json())
    .then(data => setHoroscope(data));
  }, [sign]);

  if (!horoscope) return <div>Loading...</div>;

  return (
    <div className="horoscope-card">
      <h2>{sign} - Today's Horoscope</h2>
      <p>{horoscope.prediction.overall}</p>
      <div className="details">
        <span>Lucky Numbers: {horoscope.luckyNumbers.join(', ')}</span>
        <span>Lucky Color: {horoscope.luckyColor}</span>
      </div>
    </div>
  );
}

Sun Sign vs Moon Sign

Best Practices

1. Cache daily horoscopes - They don't change throughout the day
2. Offer both Sun and Moon signs - Cover all user preferences
3. Add push notifications - "Your daily horoscope is ready!"
4. Include AI personalization - Stand out from generic horoscope apps
5. Support multiple languages - Vedika supports 22 languages