POST https://arase.masarat.sa/v1/search

{
  "query": "موسم الرياض",
  "include_answer": true, // +1
  "include_images": true, // +1
  "include_news": true // +1
}
// المجموع: 1 (أساسي) + 3 = 4 طلبات

{
  "query": "مقاهي مميزة",
  "include_places": true,
  "country": "sa",
  "user_location": {
    "lat": 24.7136,
    "lng": 46.6753
  }
}

{
  "query": "مقاهي مميزة",
  "places": [
    {
      "name": "% Arabica",
      "address": "الملك عبدالله، الرياض",
      "rating": 4.7,
      "reviews_count": 2341,
      "open_now": true,
      "location": { "lat": 24.7234, "lng": 46.6521 }
    }
  ]
}

{
  "query": "أرامكو",
  "include_news": true,
  "topic": "news"
}

{
  "query": "iPhone 15 Pro Max",
  "include_shopping": true,
  "country": "sa"
}

{
  "shopping": [
    {
      "title": "iPhone 15 Pro Max 256GB",
      "price": "4,999 ر.س",
      "source": "جرير",
      "url": "https://jarir.com/..."
    }
  ]
}

{
  "query": "الذكاء الاصطناعي في التعليم",
  "include_scholar": true,
  "topic": "academic"
}

{
  "query": "موسم الرياض 2025",
  "results": [
    {
      "title": "موسم الرياض - الموقع الرسمي",
      "url": "https://riyadhseason.sa",
      "content": "موسم الرياض هو أكبر موسم ترفيهي...",
      "score": 0.95
    }
  ],
  "answer": "موسم الرياض 2025 هو الموسم الترفيهي السنوي...",
  "images": [
    {
      "url": "https://example.com/riyadh-season.jpg",
      "title": "موسم الرياض",
      "width": 1920,
      "height": 1080
    }
  ],
  "news": [
    {
      "title": "انطلاق فعاليات موسم الرياض",
      "url": "https://news.example.com",
      "source": "العربية",
      "published_at": "2025-12-07T10:00:00Z"
    }
  ],
  "meta": {
    "responseTime": 450,
    "credits": {
      "cost": 4,
      "remaining": 96,
      "breakdown": {
        "base": 1,
        "answer": 1,
        "images": 1,
        "news": 1
      }
    },
    "plan": "free"
  }
}

{
  "mode": "extract",
  "url": "https://example.com/article",
  "include_summary": true
}

{
  "url": "https://example.com/article",
  "content": "نص المقال الكامل...",
  "summary": "ملخص المقال بالذكاء الاصطناعي..."
}

{
  "query": "سعر سهم أرامكو",
  "include_stocks": true
}

{
  "stocks": {
    "query_intent": "price",
    "market": "saudi",
    "results": [
      {
        "symbol": "2222.SR",
        "name": "أرامكو السعودية",
        "price": 28.5,
        "currency": "SAR",
        "change": 0.35,
        "changePercent": 1.24,
        "volume": 12500000
      }
    ]
  }
}

POST /api/search
{
  "query": "سعر سهم أرامكو",
  "include_stocks": true,
  "options": {
    "stocks": {
      "summary": true  # لتفعيل الملخص الذكي
    }
  }
}

{
  "stocks": {
    "query_intent": "price",
    "market": "saudi",
    "results": [
      {
        "symbol": "2222.SR",
        "name": "أرامكو السعودية",
        "price": 28.5,
        "currency": "SAR",
        "change": 0.35,
        "changePercent": 1.24,
        "volume": 12500000
      }
    ],
    "summary": "سهم أرامكو يتداول عند 28.50 ريال بارتفاع 1.24%"
  }
}

# سعر سهم
"كم سعر سهم أرامكو؟"
"What's Tesla stock price?"

# مقارنة
"قارن بين أرامكو والراجحي"

# البحث في قطاع
"أفضل أسهم البنوك السعودية"

# أخبار
"أخبار سهم أرامكو"

{
  "query": "الطقس في الرياض",
  "include_weather": true
}

{
  "weather": {
    "location": {
      "name": "الرياض",
      "country": "المملكة العربية السعودية"
    },
    "current": {
      "temp_c": 24,
      "condition": "صافٍ",
      "humidity": 35,
      "wind_kph": 12
    },
    "forecast": [
      {
        "date": "2025-12-27",
        "maxtemp_c": 26,
        "mintemp_c": 18,
        "condition": "مشمس"
      }
    ]
  }
}

POST /api/search
{
  "query": "الطقس في الرياض",
  "include_weather": true,
  "options": {
    "weather": {
      "summary": true  # لتفعيل الملخص الذكي والنصائح
    }
  }
}

{
  "weather": {
    "location": {
      "name": "الرياض",
      "country": "المملكة العربية السعودية"
    },
    "current": {
      "temp_c": 24,
      "condition": "صافٍ",
      "humidity": 35,
      "wind_kph": 12
    },
    "forecast": [
      {
        "date": "2025-12-27",
        "maxtemp_c": 26,
        "mintemp_c": 18,
        "condition": "مشمس"
      }
    ],
    "summary": "الطقس في الرياض اليوم صافٍ مع درجة حرارة 24°C. الجو مريح ومناسب للأنشطة الخارجية.",
    "advice": "ننصح بارتداء ملابس خفيفة ونظارة شمسية."
  }
}

# طقس حالي
"كيف الطقس في جدة؟"
"Weather in Dubai"

# توقعات
"الطقس في مكة الأسبوع القادم"

# مقارنة
"قارن الطقس بين الرياض ودبي"