Daily & Periodic Horoscope APIs

1. Daily & Periodic Horoscope Forecasts

1. Name

Daily & Periodic Horoscope Forecasts

2. Purpose

Provides daily, weekly, monthly, and annual horoscope predictions categorized by life areas (Career, Health, Love, Finance) for all 12 Zodiac signs (Aries through Pisces). Used by media websites and daily forecast widgets.

3. Endpoint

POST /api/v1/horoscope/{period}

4. Auth

Type: None / API Key Header Example: X-API-Key: sk_live_5f6f2e0a690a45fae957c026cbd820c83bb55461bfad3b94

5. Request Headers

Header Required Description
Content-Type Yes Must be application/json.
X-API-Key No API Key required for authenticated access.

6. Request Payload

{
  "sign": "aries",
  "period": "daily",
  "lang": "en"
}

7. Request Params Table

Field Type Required Description Allowed Values Validation Example
period string Yes (Path) Forecast frequency daily, weekly, monthly, yearly Path Segment "daily"
sign string Yes Target Zodiac sign aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces Enum "aries"
lang string No Report language "en", "hi", "ta" Default: "en" "en"

8. Request Example

{
  "sign": "aries",
  "period": "daily",
  "lang": "en"
}

9. Success Response

Status: 200 OK

{
  "status": "success",
  "message": "Horoscope retrieved successfully",
  "data": {
    "sign": "Aries",
    "period": "daily",
    "categories": {
      "overall": "Today brings fresh opportunities for initiative and creative leadership.",
      "career": "Collaborative ventures receive favorable planetary backing.",
      "love": "Clear communication enhances personal harmony.",
      "finance": "Avoid speculative expenditures today."
    }
  }
}

10. Response Fields Table

Field Type Description Nullable Example
status string Result status No "success"
data.sign string Capitalized sign name No "Aries"
data.categories.overall string General forecast narrative No "Today brings..."
data.categories.career string Career prediction No "Collaborative..."
data.categories.love string Relationship prediction No "Clear..."
data.categories.finance string Financial prediction No "Avoid..."

11. Status Codes Table

Code Meaning When Returned
200 OK Forecast retrieved.
400 Bad Request Invalid sign or period.
500 Internal Error Forecast engine exception.

12. Error Examples

{
  "status": "error",
  "message": "Invalid sign requested. Must be a valid Zodiac sign name.",
  "data": null
}

13. Frontend Usage Notes

14. Validation Rules

15. Business Rules

16. Security Notes

17. Performance Notes

19. Example Frontend Flow

  1. User selects "Aries" on Daily Horoscope widget.
  2. App sends POST /api/v1/horoscope/daily.
  3. App displays categories.

20. Complete Example

Request:

POST /api/v1/horoscope/daily HTTP/1.1
Host: api.rbos.in
Content-Type: application/json

{
  "sign": "aries",
  "lang": "en"
}

Response:

{
  "status": "success",
  "data": { "sign": "Aries", "categories": { "overall": "Energetic day ahead..." } }
}

Explanation: Retrieves daily horoscope for Aries sign.

2. Master Horoscope Report Data API

1. Name

Master Horoscope Report Data

2. Purpose

Calculates and returns all 46 structured astrological elements (birth info, panchanga, planetary positions, vargas, dashas, ashtakavarga, shadbala, yogas, doshas, etc.) required to render complete HTML/PDF horoscope reports in a single self-contained JSON response without needing downstream recalculations.

3. Endpoint

POST /api/v1/horoscope/report-data

4. Auth

Type: None / API Key (X-API-Key)

5. Request Payload

{
  "dob": "1983-10-01",
  "birth_time": "20:50:00",
  "birth_place": {
    "location_name": "Erode, Tamil Nadu, India",
    "latitude": 11.3410,
    "longitude": 77.7172,
    "timezone": "Asia/Kolkata"
  },
  "gender": "male",
  "name": "Santhosh Murthy R",
  "output_format": "pdf",
  "language": "EN",
  "chart_type": "SI"
}

6. Validation Rules