Dynamic Content

Horoscope API

Power your astrology application with highly accurate daily, weekly, monthly, and yearly horoscopes. Access beautifully categorized predictions for both Western Sun Signs and Vedic Moon Signs.

Get API Key Read Documentation →
GET /v1/horoscope/daily?sign=aries&type=sun 
{
  "sign": "Aries",
  "date": "Today",
  "predictions": {
    "general": "Your energy levels are peaking today...",
    "love": "Venus entering your 5th house brings...",
    "career": "A bold move at work pays off today...",
    "health": "Focus on grounding exercises."
  },
  "lucky_metrics": {
    "number": 9,
    "time": "14:00"
  }
}

Sun & Moon

Western & Vedic Support

Categorized

Love, Career & Health

Multi-Lingual

English, Hindi, Spanish

< 50ms

Edge-Cached Latency

Built for High-Traffic Content Platforms

Deliver engaging, fresh astrological content to your users every single day without writing a word yourself.

Daily Horoscopes

Fetch dynamically generated daily readings. You can request data for "today", "tomorrow", or "yesterday" to keep your users engaged.

Weekly & Monthly

Provide broader forecasting with our weekly and monthly endpoints, detailing long-term planetary transits and their effects on the zodiac.

Categorized Insights

Don't just serve a wall of text. Our API breaks down predictions into structured JSON keys for General, Love, Career, and Health segments.

Sun Sign vs Moon Sign

Switch effortlessly between Western Astrology (Sun Sign) and Vedic Astrology (Moon Sign / Rashi) by toggling a simple URL parameter.

Multi-Language Support

Expand your app globally. Request horoscope content instantly translated into Hindi, Spanish, French, German, or Portuguese.

Edge Caching

Horoscope requests are heavily cached at the edge level, meaning your app can handle massive morning traffic spikes without latency drops.

Predictable Endpoints

Simple GET requests make integrating horoscopes into your frontend a breeze.

GET /v1/horoscope/daily

Fetch Daily Reading

Retrieve the daily horoscope for any of the 12 zodiac signs. Customize the response by passing URL parameters for the day (`yesterday`, `today`, `tomorrow`), the type (`sun` or `moon`), and the language.

Query Parameters
?sign=taurus
&day=tomorrow
&type=sun
&lang=en
GET /v1/horoscope/period

Fetch Weekly/Monthly Reading

Access longer-term forecasts. This endpoint returns a comprehensive summary of the upcoming week or month, highlighting major astrological shifts and their direct impact on the selected sign.

JSON Response (Snippet)
"period_data": {
  "period": "Weekly",
  "date_range": "Aug 10 - Aug 16",
  "summary": "This week brings clarity to financial matters...",
  "key_transit": "Mercury enters Virgo"
}

Frequently Asked Questions

Everything you need to know about integrating the Horoscope API.

What is the Horoscope API?
The Horoscope API by PlanetsXP is a RESTful data service that allows developers to easily embed dynamically updated daily, weekly, monthly, and yearly astrological predictions into their websites or mobile apps.
Does the API support both Sun Signs and Moon Signs?
Yes. While most basic services only offer Western Sun Signs, our comprehensive astrology api allows you to toggle the `type` parameter between `sun` (Western) and `moon` (Vedic Rashi) to serve the exact astrological tradition your user base prefers.
How often is the daily horoscope api updated?
Our daily horoscope api content is generated, reviewed, and pushed to our edge servers at midnight UTC every day. You can be confident your users will always wake up to fresh content without you needing to do manual database updates.
Can I get horoscopes for tomorrow or yesterday?
Absolutely. By modifying the `day` query parameter, you can fetch horoscopes for `today`, `tomorrow`, or `yesterday`. This is highly useful for apps that allow users to preview the next day's energy or reflect on the past.
What categories of predictions does the astrology api provide?
We don't just return a massive block of text. The JSON response is neatly categorized into specific fields: General, Love, Career, and Health. This makes it incredibly easy for developers to build clean, tabbed interfaces in their UI.
Is the API suitable for high-traffic mobile apps?
Yes. Because horoscope queries (e.g., "Aries, Today") are identical for thousands of users simultaneously, our daily horoscope api heavily utilizes global Edge Caching. This ensures sub-50ms latency and zero lag, even during morning traffic spikes.
Does the daily horoscope api support multiple languages?
Yes, you can localize your app effortlessly. By passing the `lang` parameter, you can retrieve horoscope text in English, Hindi, Spanish, French, German, or Portuguese natively from the API.
Do you offer weekly, monthly, and yearly horoscopes?
Yes, our `/v1/horoscope/period` endpoint allows you to fetch long-term forecasting. Whether you need a weekly overview for a newsletter or a massive yearly prediction for an annual app update, the API handles it seamlessly.
How do I use the API for a widget on my website?
It's simple. You can use JavaScript's native `fetch()` to call the API endpoint from your frontend (using a restricted client-side key) or your backend server, and then map the JSON response fields directly into your widget's HTML structure.
Can I use the Astro AI engine to generate unique horoscopes?
If you want to go beyond general zodiac signs, yes. While the standard Horoscope API provides sign-based text, you can use our Astro AI endpoints to generate highly personalized daily predictions based on a user's exact birth chart and current planetary transits.

Ready to serve daily predictions?

Start building your content-driven astrology application today. Get up to 1,000 free API calls per month in our sandbox environment.

Get Free API Key View Docs