نتائج ويب منظّمة بطلب واحد

1. أرسل طلبك الأول

q هو المعامل المطلوب الوحيد. الطبقة العامة لا تحتاج ترويسة Authorization وتناسب التقييم والاستخدام المنخفض.

curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"

2. تعامل مع المصادر والمحتوى بشكل صحيح

source=local يأتي من فهرس TutuSoo؛ وsource=brave احتياطي ويب عند ضعف التغطية المحلية.

• استخدم الـ url المُعاد للتنقل؛ ولا تشتق عنوانًا خارجيًا من الـ id أبدًا.
• استدعِ /api/v1/content/{id} فقط للنتائج المحلية ذات id غير فارغ.
• تعامل مع 429 والمهلات وحالات عدم الاتصال والنتائج الفارغة دون إعادة محاولة لا نهائية.

3. التقسيم إلى صفحات وحدود الموارد

تعرض واجهة الويب 10 نتائج لكل صفحة وتحدّ من التصفح العميق. تحدّ الواجهة من طول الاستعلام وعدد النتائج والعمق المقبول حتى لا يحتكر طلب واحد موارد البحث.

• الاستعلامات محدودة بـ 512 حرفًا.
• limit بحدّ أقصى 100؛ ويُنصح بـ 10–20.
• time_range يُرشّح حسب وقت زحف/فهرسة TutuSoo، لا تاريخ نشر الصفحة.
• استخدم تراجعًا أسّيًا محدودًا لاستجابات 429 أو 503 لتجنّب عواصف إعادة المحاولة.