معاملات البحث
أرسل المعاملات كجسم JSON إلى POST /v1/search. فقط q مطلوب.
| الحقل | النوع | الافتراضي | الوصف |
|---|---|---|---|
q | string (1–500) | — | مطلوب. استعلام البحث. |
gl | enum | us | إصدار الدولة (انظر أدناه). |
hl | string | افتراضي الدولة | لغة الواجهة / النتائج، BCP-47 (مثل en، pt-BR). |
tbs | enum | كل الأوقات | فلتر الوقت: qdr:h (الساعة الماضية)، qdr:d (يوم)، qdr:w (أسبوع). |
page | integer (1–99) | 1 | صفحة النتائج (مفهرسة من 1؛ ~10 نتائج عضوية لكل منها). |
freshness | enum | default | التحكم في الذاكرة المؤقتة: default، realtime (فرض حديث)، cached. راجع الذاكرة المؤقتة. |
deadline_ms | integer (1000–30000) | 15000 | مهلة كل طلب بالمللي ثانية. |
الدول (gl)
Section titled “الدول (gl)”br، us، gb، de، fr، es، it، mx، ca، au، jp، nl.
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }فلتر الوقت (tbs)
Section titled “فلتر الوقت (tbs)”قصر النتائج على المحتوى الحديث — مثالي للأخبار والمواضيع الرائجة.
{ "q": "nvidia earnings", "tbs": "qdr:d" }الترقيم (page)
Section titled “الترقيم (page)”تعيد كل صفحة قرابة 10 نتائج عضوية. اطلب الصفحات 1–99؛ لجمع أول 100 نتيجة،
كرّر على الصفحات 1–10. تُظهر حزم SDK دوال مساعدة (searchPages / search_pages) تكرّر الصفحات
نيابةً عنك.