الحصول على النتائج الصحيحة من واجهة برمجة بحث Google يتعلق في الغالب بالمعاملات. إليك المرجع الكامل، باستخدام serp.cheap.
جميع المعاملات
| المعامل | النوع | الافتراضي | ماذا يفعل |
|---|---|---|---|
q | string | مطلوب | استعلام البحث |
gl | string | "us" | دولة النتائج (الموقع الجغرافي) |
hl | string | افتراضي الدولة | لغة العرض/الواجهة |
page | int | 1 | صفحة النتائج (مفهرسة من 1) |
tbs | string | لا شيء | مرشح الوقت (qdr:h/qdr:d/qdr:w) |
gl — الدولة (المعامل الذي ستستخدمه أكثر)
يحدد gl أي Google تتصل به وأي تصنيفات إقليمية تحصل عليها. المدعوم: us, br, gb, de, fr, es, it, mx, ca, au, jp, nl.
-d '{"q": "beste elektroautos", "gl": "de"}' # Germany
-d '{"q": "melhores carros elétricos", "gl": "br"}' # Brazilhl — تجاوز اللغة
يضبط gl بالفعل لغة افتراضية مناسبة. استخدم hl فقط عندما تريد نتائج بلغة مختلفة عن اللغة الافتراضية للدولة:
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Canada, in Frenchtbs — مرشح الوقت
قصر النتائج على الحديثة منها — رائع للأخبار والمراقبة والمواضيع الرائجة:
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # past 24 hours| القيمة | النطاق الزمني |
|---|---|
qdr:h | الساعة الماضية |
qdr:d | اليوم الماضي |
qdr:w | الأسبوع الماضي |
page — ترقيم الصفحات
مفهرس من 1؛ كل صفحة هي طلب منفصل يُحتسب عليه. راجع الحصول على 100 نتيجة.
تجميعها معًا
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"q": "mortgage rates", "gl": "us", "hl": "en", "page": 1, "tbs": "qdr:w"}'