Name: Horoscope API: Daily, Weekly, Monthly Readings & Forecasts
Brand: coolapps.mobi
SKU: api-coolapps.mobi-horoscope
Availability: InStock
Author: API Market

Yong Jason

# Horoscope API

## Overview
The Horoscope API provides AI-generated horoscope data tailored to specific astrological signs, time periods (daily, weekly, monthly, yearly), content types, and multiple languages. Leveraging advanced AI models, this API delivers insightful and personalized horoscope readings, making it ideal for applications requiring dynamic and engaging astrological content. Developers can easily integrate this service to enhance user experience with daily forecasts, career insights, wellness tips, and more, available instantly.

## Features
*   **Comprehensive Horoscope Data:** Access daily (yesterday, today, tomorrow), weekly, monthly, and yearly horoscopes.
*   **Multilingual Support:** Available in English, Chinese (Traditional and Simplified), Spanish, Hindi, French, Japanese, and Korean.
*   **Diverse Horoscope Types:** Retrieve specific insights for general, career, wellness, and money aspects (type availability may vary by period).
*   **AI-Powered Content Generation:** Horoscopes are generated by an AI model, ensuring unique and engaging content.
*   **Easy Integration:** Simple RESTful API with clear endpoints and JSON responses for quick implementation.
*   **Fallback Translation:** If a requested non-English language is not directly available but English content exists, the API will translate it to the desired language.

## Use Cases
*   **Personalized Content Platforms:** Integrate into mobile apps, websites, or social media platforms to offer users personalized horoscope readings based on their astrological sign.
*   **Digital Publishing & Media:** Power dynamic content for blogs, news sites, or lifestyle publications by automatically fetching daily, weekly, or monthly horoscopes.
*   **Wellness & Self-Improvement Apps:** Provide users with AI-driven wellness and career horoscopes to guide their daily decisions and self-reflection.
*   **Multilingual User Engagement:** Offer horoscope services to a global audience, catering to various language preferences and expanding user reach.
*   **Astrology & Esoteric Services:** Enhance dedicated astrology platforms with real-time, AI-generated insights, providing a modern twist to traditional horoscopes.


## API Documentation

### Base URL
All API requests should be made to:
`https://prod.api.market/api/v1/coolapps.mobi/horoscope`

### Authentication
Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```
Replace `YOUR_API_MARKET_KEY` with your actual API.market key.


### Endpoints

#### 1. Get a horoscope by sign, period, type, and language
Retrieves horoscope content based on the specified astrological sign, time period, content type, and language. If a requested non-English language is absent and English content exists, the API translates it.

**GET `/api/v1/coolapps.mobi/horoscope/get_horoscope/{sign}/{period}/{type}/{lang}`**

**Parameters:**

| Name | In | Type | Required | Description | Enum |
| :--- | :-- | :--- | :------- | :---------- | :--- |
| `sign` | path | `string` | Yes | The astrological sign for which to retrieve the horoscope. | `aries`, `taurus`, `gemini`, `cancer`, `leo`, `virgo`, `libra`, `scorpio`, `sagittarius`, `capricorn`, `aquarius`, `pisces` |
| `period` | path | `string` | Yes | The time period for the horoscope. | `yesterday`, `today`, `tomorrow`, `weekly`, `monthly`, `yearly` |
| `type` | path | `string` | Yes | The type of horoscope content requested. Type availability depends on the period; use `/get_types/{period}` to check available types. | `general`, `career`, `wellness`, `money` |
| `lang` | path | `string` | Yes | The language of the horoscope. | `en`, `zh-t`, `zh-s`, `es`, `hi`, `fr`, `ja`, `ko` |
| `x-api-market-key` | header | `string` | Yes | API.market API Key | |

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/horoscope/get_horoscope/aries/today/general/en" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "sign": "aries",
  "period": "today",
  "year": 2026,
  "month": 7,
  "day": 13,
  "timezone_offset": "-07:00",
  "language": "en",
  "general": [
    "Today, Aries, your fiery spirit is ready to take on new challenges. Expect a surge of energy that will propel you forward in personal and professional pursuits. Don't shy away from leadership roles; your natural assertiveness will be an asset. However, be mindful of impulsive decisions. Taking a moment to consider the long-term implications will serve you well. A surprise encounter could open new doors, so stay open to possibilities. Embrace the day with confidence and determination."
  ]
}
```

#### 2. List horoscope signs
Retrieves a list of all supported astrological signs.

**GET `/api/v1/coolapps.mobi/horoscope/get_signs`**

**Parameters:**

| Name | In | Type | Required | Description |
| :--- | :-- | :--- | :------- | :---------- |
| `x-api-market-key` | header | `string` | Yes | API.market API Key |

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/horoscope/get_signs" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
[
  "aries",
  "taurus",
  "gemini",
  "cancer",
  "leo",
  "virgo",
  "libra",
  "scorpio",
  "sagittarius",
  "capricorn",
  "aquarius",
  "pisces"
]
```

#### 3. List horoscope types available for a period
Retrieves the horoscope types (e.g., general, career, wellness) that are available for a specified period (e.g., today, weekly).

**GET `/api/v1/coolapps.mobi/horoscope/get_types/{period}`**

**Parameters:**

| Name | In | Type | Required | Description | Enum |
| :--- | :-- | :--- | :------- | :---------- | :--- |
| `period` | path | `string` | Yes | The time period for which to list available horoscope types. | `yesterday`, `today`, `tomorrow`, `weekly`, `monthly`, `yearly` |
| `x-api-market-key` | header | `string` | Yes | API.market API Key | |

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/horoscope/get_types/today" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "today": [
    "general",
    "wellness",
    "career",
    "love"
  ]
}
```

#### 4. List supported horoscope periods
Retrieves a list of all supported horoscope periods (e.g., daily, weekly, monthly, yearly).

**GET `/api/v1/coolapps.mobi/horoscope/get_periods`**

**Parameters:**

| Name | In | Type | Required | Description |
| :--- | :-- | :--- | :------- | :---------- |
| `x-api-market-key` | header | `string` | Yes | API.market API Key |

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/horoscope/get_periods" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
[
  "yesterday",
  "today",
  "tomorrow",
  "weekly",
  "monthly",
  "yearly"
]
```

## Status Codes
A comprehensive list of HTTP status codes returned by the API and their meanings:

*   **200 OK**: Request successful. The request was processed successfully, and the response body contains the requested data.
*   **400 Bad Request**: Invalid input parameters or malformed request. Check your request body, path parameters, and query parameters for correctness.
    *   *Example:* Unsupported `period` or `language` value.
*   **401 Unauthorized**: Missing or invalid API key. Ensure the `x-api-market-key` header is present and contains a valid API key.
    *   *Example:* `{"error": "Missing proxy secret header"}`
*   **403 Forbidden**: Valid API key but insufficient permissions or an invalid API key. Your API key may not have the necessary access rights, or the provided key is incorrect.
    *   *Example:* `{"error": "Invalid proxy secret header"}`
*   **404 Not Found**: Resource not found. This could mean the horoscope document for the requested combination of `sign`, `period`, `type`, and `language` was not found.
    *   *Example:* `{"error": "Horoscope document or requested type/language data was not found"}`
*   **429 Too Many Requests**: Rate limit exceeded. You have sent too many requests in a given amount of time. Implement exponential backoff for retries.
*   **500 Internal Server Error**: Server-side error. An unexpected error occurred on the API server.
    *   *Example:* `{"error": "No proxy secret is configured"}`
*   **503 Service Unavailable**: Service temporarily unavailable. The server is currently unable to handle the request due to temporary overload or maintenance.



## FAQ
**Q: What astrological signs are supported by the API?**

A: The API supports all twelve zodiac signs: Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, and Pisces. You can also use the `/get_signs` endpoint to retrieve a full list programmatically.

**Q: Can I get horoscopes for different timeframes?**

A: Yes, the API provides horoscopes for various periods including daily (yesterday, today, tomorrow), weekly, monthly, and yearly. Use the `/get_periods` endpoint to see all supported periods.

**Q: What languages are available for horoscopes?**

A: The API supports English (en), Chinese (Traditional `zh-t`, Simplified `zh-s`), Spanish (es), Hindi (hi), French (fr), Japanese (ja), and Korean (ko). If a non-English language is requested but not directly available, the API will translate existing English content.

**Q: How do I know which horoscope types are available for a specific period?**

A: You can use the `/get_types/{period}` endpoint to retrieve a list of supported horoscope types (e.g., general, career, wellness, money) for any given period.

**Q: Is the API synchronous or asynchronous?**

A: The Horoscope API is synchronous. All requests return the final result directly in the response without requiring job IDs or polling.

**Q: What should I do if I receive a 429 Too Many Requests error?**

A: A 429 error indicates you've exceeded the API's rate limits. You should implement an exponential backoff strategy, waiting for increasing periods before retrying your request, to avoid further rate limit penalties.

## Contact Us
If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Access comprehensive daily, weekly, monthly, and yearly horoscopes for all zodiac signs. This API delivers accurate, AI-powered forecasts, translated into multi

Horoscope API: Daily, Weekly, Monthly Readings & Forecasts

Free