API ดูดวง

การอ่านราศีขับเคลื่อนด้วย AI ดูดวงรายวัน/รายสัปดาห์/รายเดือน วิเคราะห์ความเข้ากัน อ่านไพ่ทาโรต์ นักษัตรจีน รายงานข้างขึ้นข้างแรม และคำนวณไบโอริทึม

รับ API Key ซื้อเครดิต
99.9 % เวลาทำงาน
การตอบกลับ
20 req/s
0.02 เครดิต / คำขอ

Zodiac Profile


POST https://api.yeb.to/v1/horoscope/zodiac-profile
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
sign string ไม่บังคับ Zodiac sign name (e.g. aries, leo). Required if birth_date is not provided
birth_date string ไม่บังคับ Date of birth in YYYY-MM-DD format. Required if sign is not provided
birth_time string ไม่บังคับ Time of birth in HH:MM 24h format for rising/moon sign
location string ไม่บังคับ Birth city or coordinates for natal chart precision
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/zodiac-profile \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "sign": "aries"
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "sign": "aries",
    "personalized": false
  },
  "reading": {
    "element": "fire",
    "ruling_planet": "Mars",
    "traits": ["courageous", "determined", "confident"],
    "strengths": "Natural born leader with infectious enthusiasm. Aries thrives when pioneering new projects and inspires others through bold action and unwavering determination.",
    "weaknesses": "Can be impatient and impulsive. The desire to be first sometimes leads to hasty decisions and a reluctance to consider alternative viewpoints.",
    "compatibility": ["leo", "sagittarius"],
    "description": "Aries is the first sign of the zodiac, symbolizing new beginnings and raw energy. Ruled by Mars, the planet of action, Aries individuals are natural trailblazers who approach life with courage and enthusiasm. Their cardinal fire nature makes them initiators who thrive on challenge and competition."
  },
  "response_code": 200,
  "response_time_ms": 1240
}
{"error":"sign or birth_date is required","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Zodiac Profile

horoscope/zodiac-profile 0.0200 credits

Parameters

API Key
body · string · required
Zodiac Sign
body · string
Birth Date
body · string
Birth Time
body · string
Location
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Daily Horoscope


POST https://api.yeb.to/v1/horoscope/daily-horoscope
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
sign string ไม่บังคับ Zodiac sign name (e.g. aries). Required if birth_date is not provided
birth_date string ไม่บังคับ Date of birth in YYYY-MM-DD format. Required if sign is not provided
date string ไม่บังคับ Target date in YYYY-MM-DD format (default: today)
birth_time string ไม่บังคับ Time of birth in HH:MM 24h format for personalized reading
location string ไม่บังคับ Birth city or coordinates for natal chart precision
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/daily-horoscope \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "sign": "aries",
  "date": "2026-02-20"
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "sign": "aries",
    "period": "daily",
    "date": "2026-02-20",
    "personalized": false
  },
  "reading": {
    "general": "Today brings a surge of creative energy that fuels both personal projects and professional ambitions. Trust your instincts when an unexpected opportunity appears in the afternoon.",
    "love": "Romance is highlighted as Venus forms a favorable aspect to your sign. Single Aries may catch someone's eye during a social outing, while coupled Aries benefit from honest, heartfelt conversation.",
    "career": "A professional opportunity surfaces that aligns with your long-term goals. Your assertive communication style wins over a skeptical colleague. Avoid rushing financial decisions until evening.",
    "health": "Take time to stretch and move your body early in the day. High energy levels demand an outlet \u2014 consider a brisk walk or workout to channel the Mars-driven vitality constructively.",
    "lucky_number": 7,
    "lucky_color": "red",
    "mood": "energetic"
  },
  "response_code": 200,
  "response_time_ms": 1380
}
{"error":"sign or birth_date is required","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Daily Horoscope

horoscope/daily-horoscope 0.0200 credits

Parameters

API Key
body · string · required
Zodiac Sign
body · string
Birth Date
body · string
Target Date
body · string
Birth Time
body · string
Location
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Weekly Horoscope


POST https://api.yeb.to/v1/horoscope/weekly-horoscope
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
sign string ไม่บังคับ Zodiac sign name (e.g. taurus). Required if birth_date is not provided
birth_date string ไม่บังคับ Date of birth in YYYY-MM-DD format. Required if sign is not provided
birth_time string ไม่บังคับ Time of birth in HH:MM 24h format for personalized reading
location string ไม่บังคับ Birth city or coordinates for natal chart precision
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/weekly-horoscope \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "sign": "taurus"
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "sign": "taurus",
    "period": "weekly",
    "week_start": "2026-02-16",
    "week_end": "2026-02-22",
    "personalized": false
  },
  "reading": {
    "overview": "This week encourages Taurus to focus on financial planning and creative expression. Venus, your ruling planet, enters a harmonious position mid-week, boosting both romance and artistic pursuits.",
    "love": "Relationships deepen through shared experiences early in the week. Wednesday and Thursday are ideal for date nights or meaningful conversations with a partner. Singles may find a promising connection through mutual friends.",
    "career": "Monday and Tuesday bring productive energy for tackling complex projects. A collaborative opportunity arises around Thursday \u2014 be open to unconventional approaches. Financial discussions on Friday yield positive results.",
    "health": "Prioritize rest on Monday as the week ahead is demanding. Mid-week brings peak physical energy, making it the best time for exercise. Watch for tension in the neck and shoulders \u2014 stretching helps.",
    "highlights": {
      "best_day": "Thursday",
      "challenging_day": "Monday",
      "focus_area": "finances"
    }
  },
  "response_code": 200,
  "response_time_ms": 1520
}
{"error":"sign or birth_date is required","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Weekly Horoscope

horoscope/weekly-horoscope 0.0200 credits

Parameters

API Key
body · string · required
Zodiac Sign
body · string
Birth Date
body · string
Birth Time
body · string
Location
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Monthly Horoscope


POST https://api.yeb.to/v1/horoscope/monthly-horoscope
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
sign string ไม่บังคับ Zodiac sign name (e.g. gemini). Required if birth_date is not provided
birth_date string ไม่บังคับ Date of birth in YYYY-MM-DD format. Required if sign is not provided
month string ไม่บังคับ Target month in YYYY-MM format (default: current month)
birth_time string ไม่บังคับ Time of birth in HH:MM 24h format for personalized reading
location string ไม่บังคับ Birth city or coordinates for natal chart precision
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/monthly-horoscope \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "sign": "gemini",
  "month": "2026-03"
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "sign": "gemini",
    "period": "monthly",
    "month": "2026-03",
    "personalized": false
  },
  "reading": {
    "overview": "March 2026 is a transformative month for Gemini. Mercury, your ruling planet, goes direct on the 5th, clearing communication blockages that may have built up. The second half of the month favors bold career moves and intellectual pursuits.",
    "love": "The first week brings clarity to an ongoing romantic situation. Mid-month, Venus transiting your communication sector makes it easy to express feelings you have been holding back. Couples benefit from planning a shared adventure.",
    "career": "After Mercury goes direct, stalled projects regain momentum. The 12th through 18th are particularly powerful for negotiations, presentations, and signing agreements. A mentor figure offers valuable guidance around the 20th.",
    "health": "March rewards consistent routines over dramatic changes. Focus on sleep hygiene during the first two weeks when mental restlessness peaks. The last week brings renewed vitality \u2014 an ideal time to start a new fitness routine.",
    "key_dates": ["2026-03-05", "2026-03-14", "2026-03-22"],
    "themes": ["communication", "career advancement", "intellectual growth"],
    "planetary_influences": "Mercury direct (Mar 5), Full Moon in Virgo (Mar 14), Sun conjunct Neptune (Mar 22)"
  },
  "response_code": 200,
  "response_time_ms": 1650
}
{"error":"sign or birth_date is required","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Monthly Horoscope

horoscope/monthly-horoscope 0.0200 credits

Parameters

API Key
body · string · required
Zodiac Sign
body · string
Birth Date
body · string
Target Month
body · string
Birth Time
body · string
Location
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Compatibility


POST https://api.yeb.to/v1/horoscope/compatibility
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
sign_a string ไม่บังคับ First zodiac sign (e.g. aries). Required if birth_date_a is not provided
sign_b string ไม่บังคับ Second zodiac sign (e.g. leo). Required if birth_date_b is not provided
birth_date_a string ไม่บังคับ First person’s birth date in YYYY-MM-DD. Required if sign_a is not provided
birth_date_b string ไม่บังคับ Second person’s birth date in YYYY-MM-DD. Required if sign_b is not provided
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/compatibility \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "sign_a": "aries",
  "sign_b": "leo"
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "sign_a": "aries",
    "sign_b": "leo",
    "personalized": false
  },
  "reading": {
    "overall_score": 92,
    "love": {
      "score": 95,
      "description": "A fiery match made in the stars. Both Aries and Leo crave passion, excitement, and mutual admiration. Their shared fire element creates an electric connection that keeps the spark alive through bold gestures and heartfelt loyalty."
    },
    "friendship": {
      "score": 90,
      "description": "These two signs form a dynamic and adventurous friendship. Aries brings spontaneity while Leo adds warmth and generosity. They push each other to achieve greater things and celebrate each other's victories wholeheartedly."
    },
    "communication": {
      "score": 88,
      "description": "Direct and expressive, both signs prefer honesty over diplomacy. Occasional clashes arise when two strong egos compete for the spotlight, but their mutual respect ensures conflicts resolve quickly."
    },
    "summary": "Aries and Leo share a dynamic and passionate bond rooted in mutual respect, shared ambition, and a love for adventure. Their fire-element connection fuels both romance and friendship with natural enthusiasm."
  },
  "response_code": 200,
  "response_time_ms": 1450
}
{"error":"sign_a and sign_b (or birth_date_a and birth_date_b) are required","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Compatibility

horoscope/compatibility 0.0200 credits

Parameters

API Key
body · string · required
Sign A
body · string
Sign B
body · string
Birth Date A
body · string
Birth Date B
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Tarot Reading


POST https://api.yeb.to/v1/horoscope/tarot-reading
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
spread string ไม่บังคับ Spread type: single, three (default), or celtic_cross
question string ไม่บังคับ A question or topic to focus the reading on (max 500 chars)
birth_date string ไม่บังคับ Date of birth in YYYY-MM-DD for personalized interpretation
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/tarot-reading \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "spread": "three",
  "question": "What should I focus on in my career this month?"
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "spread": "three",
    "drawn_cards": [
      {
        "name": "The Fool",
        "arcana": "major",
        "number": 0,
        "reversed": false
      },
      {
        "name": "Two of Cups",
        "arcana": "minor",
        "number": 2,
        "reversed": true
      },
      {
        "name": "The Star",
        "arcana": "major",
        "number": 17,
        "reversed": false
      }
    ],
    "personalized": false
  },
  "reading": {
    "cards": [
      {
        "position": "Past",
        "card": "The Fool",
        "meaning": "A period of new beginnings and fearless exploration laid the groundwork for where you stand today. You took a leap of faith that, while risky, opened doors to unexpected possibilities."
      },
      {
        "position": "Present",
        "card": "Two of Cups (reversed)",
        "meaning": "A partnership or collaboration at work may feel imbalanced right now. There could be miscommunication or differing expectations with a colleague. Address this directly rather than letting tension build."
      },
      {
        "position": "Future",
        "card": "The Star",
        "meaning": "Hope and renewal are on the horizon. After navigating the current challenges, a period of clarity and inspiration awaits. Trust in your long-term vision \u2014 the universe is aligning to support your authentic career path."
      }
    ],
    "overall": "The cards suggest a journey from bold beginnings through a present moment of relational tension, resolving into a future filled with hope and renewed purpose. Address the current imbalance head-on, and the clarity you seek will follow naturally."
  },
  "response_code": 200,
  "response_time_ms": 1580
}
{"error":"invalid spread type, must be single, three, or celtic_cross","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Tarot Reading

horoscope/tarot-reading 0.0300 credits

Parameters

API Key
body · string · required
Spread
body · string
Question
body · string
Birth Date
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Chinese Zodiac


POST https://api.yeb.to/v1/horoscope/chinese-zodiac
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
birth_year integer ไม่บังคับ Birth year (e.g. 1988). Required if birth_date is not provided
birth_date string ไม่บังคับ Date of birth in YYYY-MM-DD format. Required if birth_year is not provided
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/chinese-zodiac \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "birth_year": 1988
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "animal": "dragon",
    "element": "earth",
    "year": 1988,
    "yin_yang": "yang"
  },
  "reading": {
    "personality": "Earth Dragons are grounded, practical, and ambitious. They possess the Dragon's natural charisma tempered by the Earth element's stability. They are excellent strategists who build lasting foundations rather than chasing fleeting victories.",
    "career": "Earth Dragons excel in leadership roles that require both vision and pragmatism. Fields like architecture, finance, project management, and entrepreneurship suit their blend of creativity and discipline.",
    "love": "In relationships, Earth Dragons are loyal and protective partners. They seek stability and emotional depth, preferring a steady and committed partnership over whirlwind romances. Their ideal match values trust and shared long-term goals.",
    "health": "The Earth element brings resilience but also a tendency to overwork. Earth Dragons should prioritize regular rest, mindful eating, and stress management to maintain their considerable stamina over the long term."
  },
  "response_code": 200,
  "response_time_ms": 1290
}
{"error":"birth_year or birth_date is required","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Chinese Zodiac

horoscope/chinese-zodiac 0.0200 credits

Parameters

API Key
body · string · required
Birth Year
body · string
Birth Date
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Chinese Year Forecast


POST https://api.yeb.to/v1/horoscope/chinese-year-forecast
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
birth_year integer ไม่บังคับ Birth year (e.g. 1988). Required if birth_date is not provided
birth_date string ไม่บังคับ Date of birth in YYYY-MM-DD format. Required if birth_year is not provided
year integer ไม่บังคับ Forecast year (e.g. 2026). Defaults to the current year
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/chinese-year-forecast \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "birth_year": 1988,
  "year": 2026
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "animal": "dragon",
    "element": "earth",
    "year": 1988,
    "yin_yang": "yang",
    "forecast_year": 2026
  },
  "reading": {
    "overview": "2026 is the Year of the Fire Horse, bringing dynamic and transformative energy for Earth Dragons. The Fire element challenges you to step outside your comfort zone and embrace change. This is a year of accelerated growth, particularly in career and personal development.",
    "career": "Professional momentum builds through the first half of the year. The Dragon's natural leadership qualities are amplified by the Horse's forward-driving energy. A significant career opportunity arrives around the third quarter \u2014 be prepared to act decisively.",
    "love": "Romantic relationships benefit from open communication and spontaneity this year. The Horse energy encourages Earth Dragons to be more expressive with their feelings. Single Dragons may find a meaningful connection during spring or late autumn.",
    "health": "The fast pace of the Horse year can exhaust even the resilient Dragon. Schedule regular downtime and avoid overcommitting during the summer months. Outdoor activities and connection with nature help maintain balance throughout the year.",
    "lucky_months": [3, 7, 11]
  },
  "response_code": 200,
  "response_time_ms": 1480
}
{"error":"birth_year or birth_date is required","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Chinese Year Forecast

horoscope/chinese-year-forecast 0.0200 credits

Parameters

API Key
body · string · required
Birth Year
body · string
Birth Date
body · string
Forecast Year
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Moon Phase Report


POST https://api.yeb.to/v1/horoscope/moon-phase-report
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
date string ไม่บังคับ Target date in YYYY-MM-DD format (default: today)
birth_date string ไม่บังคับ Date of birth in YYYY-MM-DD for personalized lunar guidance
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/moon-phase-report \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "date": "2026-02-20"
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "phase_name": "Waxing Gibbous",
    "illumination_pct": 78.5,
    "moon_age_days": 10.3,
    "moon_sign": "scorpio"
  },
  "reading": {
    "energy": "The Waxing Gibbous phase carries building momentum and heightened intuition. As the moon approaches fullness, projects started during the New Moon gain traction. This is a time for refinement, adjustment, and trusting your gut instincts.",
    "emotional_impact": "Emotions intensify under the Scorpio moon, bringing depth and passion to interactions. You may feel drawn to uncover hidden truths or confront unresolved feelings. Channel this transformative energy constructively through journaling or deep conversation.",
    "best_activities": [
      "Refining existing projects and plans",
      "Deep research and investigation",
      "Emotional healing and therapy sessions",
      "Strengthening intimate relationships",
      "Financial planning and investment review"
    ],
    "avoid": [
      "Starting entirely new ventures (wait for the next New Moon)",
      "Superficial socializing when deep connection is needed",
      "Ignoring strong emotional signals",
      "Making impulsive purchases"
    ]
  },
  "response_code": 200,
  "response_time_ms": 1120
}
{"error":"invalid date format, use YYYY-MM-DD","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Moon Phase Report

horoscope/moon-phase-report 0.0200 credits

Parameters

API Key
body · string · required
Date
body · string
Birth Date
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Biorhythm


POST https://api.yeb.to/v1/horoscope/biorhythm
พารามิเตอร์ประเภทจำเป็นคำอธิบาย
api_key string ใช่ Your API key
birth_date string ใช่ Date of birth in YYYY-MM-DD format (required for cycle calculation)
target_date string ไม่บังคับ Date to calculate biorhythm for in YYYY-MM-DD (default: today)
language string ไม่บังคับ Two-letter ISO 639-1 language code (default: en)

ตัวอย่าง

curl -X POST https://api.yeb.to/v1/horoscope/biorhythm \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "birth_date": "1990-05-15",
  "target_date": "2026-02-20"
}'

ตัวอย่างการตอบกลับ

{
  "computed_data": {
    "birth_date": "1990-05-15",
    "target_date": "2026-02-20",
    "days_alive": 13065,
    "physical": {
      "value": 72,
      "phase": "high",
      "cycle_day": 5
    },
    "emotional": {
      "value": -34,
      "phase": "low",
      "cycle_day": 21
    },
    "intellectual": {
      "value": 95,
      "phase": "high",
      "cycle_day": 8
    },
    "average": 44
  },
  "reading": {
    "summary": "Your physical and intellectual cycles are both in their high phases, creating a powerful window for mentally demanding physical tasks. However, the emotional cycle is in a low phase, so be mindful of stress and avoid emotionally charged decisions today.",
    "physical_advice": "Physical energy is strong at 72% on day 5 of the 23-day cycle. This is an excellent time for exercise, sports, and physically demanding work. Your body recovers quickly and stamina is above average.",
    "emotional_advice": "Emotional sensitivity is heightened in the low phase at -34% on day 21 of the 28-day cycle. Avoid confrontations and major relationship decisions. Practice self-care and seek calming activities like meditation or nature walks.",
    "intellectual_advice": "Mental acuity peaks at 95% on day 8 of the 33-day cycle. This is the ideal time for learning, problem-solving, creative work, and strategic planning. Take advantage of this clarity for complex tasks."
  },
  "response_code": 200,
  "response_time_ms": 890
}
{"error":"birth_date is required","code":422}

รหัสตอบกลับ

รหัสคำอธิบาย
200 Successคำขอดำเนินการสำเร็จ
400 Bad Requestการตรวจสอบข้อมูลนำเข้าล้มเหลว
401 UnauthorizedAPI Key หายไปหรือไม่ถูกต้อง
403 ForbiddenKey ไม่ทำงานหรือไม่ได้รับอนุญาต
429 Rate Limitคำขอมากเกินไป
500 Server Errorข้อผิดพลาดที่ไม่คาดคิด

Biorhythm

horoscope/biorhythm 0.0200 credits

Parameters

API Key
body · string · required
Birth Date
body · string · required
Target Date
body · string
Language
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

API ดูดวง — Practical Guide

A comprehensive guide to the Horoscope API: AI-powered zodiac readings, daily/weekly/monthly horoscopes, compatibility analysis, tarot card readings, Chinese zodiac, moon phase reports, and biorhythm calculations. Personalize every reading with birth data for deeper accuracy.

#What the Horoscope API does

The Horoscope API provides 10 endpoints covering the full spectrum of astrological and metaphysical readings: zodiac sign profiles, daily/weekly/monthly horoscopes, romantic and friendship compatibility, tarot card spreads, Chinese zodiac profiles and yearly forecasts, moon phase reports, and biorhythm cycles. Every reading is generated with AI and can be personalized using birth date, birth time, and location data for natal-chart-level accuracy.

#Endpoints at a glance

Endpoint What it does Credits
zodiac-profile Full zodiac sign profile: element, ruling planet, traits, strengths, weaknesses, and compatibility 0.02
daily-horoscope Daily horoscope reading with love, career, health, lucky number, color, and mood 0.02
weekly-horoscope Weekly outlook covering all life areas with day-by-day highlights 0.02
monthly-horoscope In-depth monthly forecast with key dates, themes, and planetary influences 0.02
compatibility Romantic and friendship compatibility score between two zodiac signs 0.02
tarot-reading AI-generated tarot card spread with per-card meanings and overall interpretation 0.03
chinese-zodiac Chinese zodiac animal profile based on birth year with element and yin/yang 0.02
chinese-year-forecast Yearly Chinese zodiac forecast with lucky months and life-area predictions 0.02
moon-phase-report Current or date-specific moon phase with energy, mood, and activity guidance 0.02
biorhythm Physical, emotional, and intellectual biorhythm cycles with daily advice 0.02

#How personalization works

Most endpoints accept either a sign name (e.g. aries) or a birth_date in YYYY-MM-DD format. When you provide a birth date, the API automatically determines the zodiac sign and sets personalized: true in the response.

For deeper accuracy, add optional birth_time (HH:MM, 24-hour format) and location (city name or coordinates). This enables natal chart calculations including rising sign, moon sign, and planetary house positions, which are woven into the reading.

POST
curl -X POST https://api.yeb.to/v1/horoscope/daily-horoscope \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "birth_date": "1990-05-15",
    "birth_time": "14:30",
    "location": "New York"
  }'

Without birth data, pass sign directly for a general reading:

POST
curl -X POST https://api.yeb.to/v1/horoscope/daily-horoscope \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "sign": "aries"
  }'

#Western zodiac endpoints

Four endpoints cover the Western astrological system: zodiac-profile for static sign data, and daily-horoscope, weekly-horoscope, and monthly-horoscope for time-based readings.

#POST /v1/horoscope/zodiac-profile

  • Best for: Sign overview pages, onboarding flows, profile cards
  • Returns: Element, ruling planet, traits, strengths, weaknesses, compatible signs, full description
  • Personalized: Add birth data for rising sign and moon sign integration

#POST /v1/horoscope/daily-horoscope

  • Best for: Daily horoscope widgets, morning notification content, lifestyle apps
  • Returns: General, love, career, health readings plus lucky number, color, and mood
  • Optional date: Fetch a reading for a specific date (YYYY-MM-DD)

#POST /v1/horoscope/weekly-horoscope

  • Best for: Weekly newsletter content, planning features
  • Returns: Week-level overview with day-by-day highlights and focus areas

#POST /v1/horoscope/monthly-horoscope

  • Best for: Monthly forecast features, editorial content
  • Returns: In-depth monthly reading with planetary influences, key dates, and themes
  • Optional month: Specify month as YYYY-MM (defaults to current)

#Compatibility analysis

The compatibility endpoint compares two zodiac signs across multiple dimensions: love, friendship, and communication. Pass either sign names (sign_a + sign_b) or birth dates (birth_date_a + birth_date_b) for personalized results.

  • Scores: Each dimension gets a 0-100 score plus a descriptive analysis
  • Overall: Weighted overall compatibility percentage
  • Use case: Dating apps, social features, relationship guidance tools

#Tarot card readings

The tarot-reading endpoint simulates a tarot card draw with AI-interpreted meanings. Three spread types are available:

  • single — One card draw for a quick insight or daily guidance
  • three — Past / Present / Future spread (default)
  • celtic_cross — Full 10-card Celtic Cross for deep analysis

Cards are drawn from the full 78-card deck (22 Major Arcana + 56 Minor Arcana) with reversed positions possible. Pass an optional question to focus the reading on a specific topic.

#Chinese zodiac

Two endpoints cover the Chinese astrological system:

#POST /v1/horoscope/chinese-zodiac

  • Input: birth_year (e.g. 1988) or birth_date
  • Returns: Animal sign, element (wood/fire/earth/metal/water), yin/yang polarity, personality, career, love, and health traits

#POST /v1/horoscope/chinese-year-forecast

  • Input: Same as above, plus optional year for the forecast year
  • Returns: Yearly overview, career, love, health forecasts, and lucky months
  • Use case: Lunar New Year features, yearly planning tools

#Moon phases & biorhythm

#POST /v1/horoscope/moon-phase-report

  • Returns: Current moon phase name, illumination percentage, moon age in days, and the moon’s zodiac sign
  • Reading: Energy description, emotional impact, recommended and discouraged activities
  • Optional date: Query a specific date (defaults to today)
  • Optional birth_date: Adds personalized lunar guidance

#POST /v1/horoscope/biorhythm

  • Requires: birth_date (always required for cycle calculation)
  • Returns: Physical (23-day), emotional (28-day), and intellectual (33-day) cycle values (-100 to +100)
  • Reading: Summary plus specific advice for each cycle
  • Optional target_date: Calculate for a future or past date

#Supported zodiac signs

All Western zodiac endpoints accept these 12 sign values (case-insensitive):

SignDatesElementRuling Planet
ariesMar 21 – Apr 19FireMars
taurusApr 20 – May 20EarthVenus
geminiMay 21 – Jun 20AirMercury
cancerJun 21 – Jul 22WaterMoon
leoJul 23 – Aug 22FireSun
virgoAug 23 – Sep 22EarthMercury
libraSep 23 – Oct 22AirVenus
scorpioOct 23 – Nov 21WaterPluto
sagittariusNov 22 – Dec 21FireJupiter
capricornDec 22 – Jan 19EarthSaturn
aquariusJan 20 – Feb 18AirUranus
piscesFeb 19 – Mar 20WaterNeptune

#Language support

Every endpoint accepts an optional language parameter to receive the reading in a specific language. Pass a two-letter ISO 639-1 code (e.g. en, es, fr, de, bg, ja, zh). Defaults to en (English) when omitted.

#Common use cases

  • Horoscope apps — Daily push notifications with personalized zodiac readings
  • Dating platforms — Compatibility scores as icebreakers or profile features
  • Lifestyle & wellness apps — Moon phase rituals, biorhythm tracking, tarot guidance
  • Content publishers — Auto-generate daily/weekly/monthly horoscope columns in any language
  • Chatbots & virtual assistants — Conversational horoscope readings via API
  • E-commerce — Personalized product recommendations based on zodiac traits
  • Gaming — Tarot card mini-games, zodiac-themed character creation

#Best practices

  1. Cache daily readings: daily-horoscope for a given sign and date produces consistent results — cache for 24h to save credits
  2. Use birth_date over sign: Birth date unlocks automatic sign detection and personalization; storing the sign on your side is unnecessary
  3. Progressive personalization: Start with just sign, then prompt users to add birth date and time for richer readings
  4. Tarot spread selection: Use single for quick daily draws, three for standard readings, celtic_cross for premium features
  5. Biorhythm charts: Query multiple target_date values to build a 30-day cycle chart on the frontend
  6. Handle rate limits: Implement exponential backoff for 429 responses
  7. Language fallback: If a language is not well-supported, the API falls back to English

#API Changelog

2026-02-20
v1.0 Launch: Initial release with 10 endpoints — zodiac-profile, daily/weekly/monthly horoscopes, compatibility, tarot-reading, chinese-zodiac, chinese-year-forecast, moon-phase-report, and biorhythm. AI-powered readings with optional personalization via birth data. Multi-language support across all endpoints.

คำถามที่พบบ่อย

ส่ง birth_date, birth_time และ location พร้อมกับพารามิเตอร์ sign API จะคำนวณแผนที่ดวงดาวเกิดและเสริมพรอมต์ AI ด้วยตำแหน่งดาวเคราะห์ ทำให้การอ่านเป็นเอกลักษณ์สำหรับคุณแทนที่จะเป็นแบบทั่วไป

ไม่ ทุกคำขอจะสร้างการอ่าน AI ใหม่ แม้แต่การเรียกสองครั้งด้วยพารามิเตอร์เดียวกันก็จะส่งคืนข้อความที่แตกต่างกัน ดังนั้นแต่ละการตอบกลับจึงไม่ซ้ำกัน

ส่งรหัส ISO 639-1 ใดก็ได้ในพารามิเตอร์ language (เช่น en, bg, de, fr, es, ja) AI จะสร้างการอ่านทั้งหมดในภาษาที่ร้องขอ

ส่งราศีสองราศีเพื่อรับรายงานความเข้ากันทั่วไป สำหรับการวิเคราะห์ที่ลึกขึ้น ให้รวม birth_date_a และ birth_date_b แล้ว API จะคำนวณซินแอสทรีเต็มรูปแบบก่อนสร้างการอ่าน

API สุ่มจั่วไพ่จากสำรับเต็ม 78 ใบ (อาร์คานาเอก + อาร์คานาโท) เลือกการวาง: single (1 ใบ), three (อดีต/ปัจจุบัน/อนาคต) หรือ celtic_cross (10 ใบ) การจั่วและการตีความแต่ละครั้งไม่ซ้ำกัน

การอ่านทั่วไปตามราศีราคา 0.02 เครดิต การอ่านเฉพาะบุคคล (พร้อมข้อมูลเกิด) ราคา 0.05 เครดิต การอ่านไพ่ทาโรต์ราคา 0.03 เครดิต จุดเชื่อมต่อไบโอริทึมราคา 0.02 เครดิตเสมอ

ใช่ ทุกคำขอ แม้แต่ที่เกิดข้อผิดพลาด จะใช้เครดิต เครดิตของคุณผูกกับจำนวนคำขอ ไม่ว่าจะสำเร็จหรือล้มเหลว หากข้อผิดพลาดเกิดจากปัญหาของแพลตฟอร์มฝั่งเราอย่างชัดเจน เราจะคืนเครดิตที่ได้รับผลกระทบ (ไม่มีการคืนเงินสด)

ติดต่อเราที่ [email protected] เรารับฟังความคิดเห็นอย่างจริงจัง—หากรายงานข้อบกพร่องหรือคำขอฟีเจอร์ของคุณมีความหมาย เราสามารถแก้ไขหรือปรับปรุง API ได้อย่างรวดเร็วและมอบเครดิตฟรี 50 เครดิตเป็นการขอบคุณ

ขึ้นอยู่กับ API และบางครั้งรวมถึง endpoint ด้วย บาง endpoint ใช้ข้อมูลจากแหล่งภายนอกซึ่งอาจมีขีดจำกัดที่เข้มงวดกว่า เรายังบังคับใช้ขีดจำกัดเพื่อป้องกันการใช้ในทางที่ผิดและรักษาเสถียรภาพของแพลตฟอร์ม ตรวจสอบเอกสารสำหรับขีดจำกัดเฉพาะของแต่ละ endpoint

เราใช้ระบบเครดิต เครดิตเป็นหน่วยจ่ายล่วงหน้าที่ไม่สามารถคืนเงินได้ ใช้สำหรับการเรียก API และเครื่องมือ เครดิตถูกใช้แบบ FIFO (เก่าสุดก่อน) และมีอายุ 12 เดือนนับจากวันที่ซื้อ แดชบอร์ดแสดงวันที่ซื้อแต่ละครั้งและวันหมดอายุ

ใช่ เครดิตที่ซื้อทั้งหมด (รวมถึงยอดคงเหลือเศษส่วน) มีอายุ 12 เดือนนับจากการซื้อ เครดิตที่ไม่ได้ใช้จะหมดอายุโดยอัตโนมัติและถูกลบอย่างถาวรเมื่อสิ้นสุดระยะเวลาที่มีผล เครดิตที่หมดอายุไม่สามารถกู้คืนหรือแปลงเป็นเงินสดหรือมูลค่าอื่นได้ กฎเปลี่ยนผ่าน: เครดิตที่ซื้อก่อน 22 ก.ย. 2025 ถือว่าซื้อเมื่อ 22 ก.ย. 2025 และหมดอายุ 22 ก.ย. 2026 (เว้นแต่ระบุวันหมดอายุที่เร็วกว่าตอนซื้อ)

ใช่—ภายในระยะเวลาที่มีผล เครดิตที่ไม่ได้ใช้ยังคงใช้ได้และยกยอดจากเดือนต่อเดือนจนกว่าจะหมดอายุ 12 เดือนหลังการซื้อ

เครดิตไม่สามารถคืนเงินได้ ซื้อเฉพาะที่คุณต้องการ—คุณสามารถเติมได้ภายหลังเสมอ หากข้อผิดพลาดของแพลตฟอร์มทำให้การเรียกเก็บเงินล้มเหลว เราอาจคืนเครดิตที่ได้รับผลกระทบหลังจากการตรวจสอบ ไม่มีการคืนเงินสด

ราคากำหนดเป็นเครดิต ไม่ใช่ดอลลาร์ แต่ละ endpoint มีราคาของตัวเอง—ดูป้าย "เครดิต / คำขอ" ด้านบน คุณจะรู้ค่าใช้จ่ายที่แน่นอนเสมอ
← กลับไปที่ API