هذا هو الدليل العملي الشامل لاستخدام Google Search API: المصادقة، إرسال استعلام، قراءة JSON، التصفّح، معالجة الأخطاء، وخفض التكاليف. تستخدم الأمثلة serp.cheap (الخيار الأرخص في 2026)، لكن المفاهيم تنطبق على أي SERP API.
1. احصل على مفتاح API
سجّل على app.serp.cheap واحصل على 100 عملية بحث مجانية (دون بطاقة)، ثم مرّر مفتاحك في ترويسة X-API-Key. يمكنك أيضاً الاشتراك عبر Apify أو RapidAPI إن كنت تفضّل الفوترة عبر السوق.
2. نقطة النهاية في سطر واحد
POST https://api.serp.cheap/v1/search| المعامل | الافتراضي | الوصف |
|---|---|---|
q | مطلوب | استعلام البحث |
gl | "us" | الدولة (مثل br، gb، de) |
hl | افتراضي الدولة | تجاوز لغة الواجهة |
page | 1 | صفحة النتائج (تبدأ من 1) |
tbs | لا شيء | مرشّح الوقت: qdr:h، qdr:d، qdr:w |
المرجع الكامل: معاملات Google Search API.
3. طلبك الأول
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'import requests
r = requests.post(
"https://api.serp.cheap/v1/search",
headers={"X-API-Key": "YOUR_KEY"},
json={"q": "best electric cars 2026", "gl": "us", "page": 1},
)
r.raise_for_status()
data = r.json()
for item in data["organic"]:
print(item["position"], item["title"], item["link"])أدلّة خاصة بكل لغة: Python · Node.js · PHP · Go · curl.
4. اقرأ الرد
{
"search": "best electric cars 2026",
"page": 1,
"organic": [
{
"position": 1,
"title": "Best Electric Cars of 2026",
"link": "https://example.com/best-evs",
"snippet": "We tested every major EV...",
"date": "Jan 10, 2026"
}
],
"stats": { "balance": 99994, "cost": 6, "cached": false }
}stats.cost محسوبة بالأرصدة (1 رصيد = $0.0001). الجلب الجديد يكلّف 6 أرصدة ($0.0006)؛ ونتيجة التخزين المؤقت تكلّف 3 ($0.0003). يخبرك stats.cached بالمسار الذي حصلت عليه.
5. التصفّح عبر الصفحات
كل صفحة هي طلب منفصل — زِد قيمة page. اجلب الصفحة 2 وما بعدها فقط عندما يحتاجها المستخدم فعلاً. انظر الحصول على 100 نتيجة.
6. معالجة الأخطاء
- 401 — مفتاح API خاطئ أو مفقود.
- 402 — نفاد الأرصدة؛ أعد الشحن.
- 429 — تجاوز حد المعدّل (60 طلباً/دقيقة (طلب واحد/ثانية) على الباقة المجانية؛ 600/دقيقة (10 طلبات/ثانية) في الدفع حسب الاستخدام؛ حتى 60 طلباً/ثانية على الباقات الأعلى)؛ تراجع وأعد المحاولة.
- 5xx — عابر؛ أعد المحاولة مع تراجع أسّي.
غلّف الاستدعاءات دائماً بإعادة محاولة مع تراجع للأخطاء 429/5xx.
7. أبقها رخيصة
- نتائج التخزين المؤقت بنصف السعر — لا تفرض جلباً جديداً للاستعلامات المتكرّرة.
- تصفّح بشكل كسول.
- اختر
glبدقّة لتجنّب إعادة التشغيل.
الخطوات التالية
- ابنِ شيئاً حقيقياً: أداة تتبّع تصنيف بـ Python أو Google Search لوكلاء الذكاء الاصطناعي.
- قارن المزوّدين: أرخص SERP API في 2026.
جرّب serp.cheap
شغّل طلبات هذا الدليل على نقطة النهاية الحية خلال دقيقتين. 100 عملية بحث مجانية عند التسجيل — دون بطاقة؛ ثم الدفع حسب الاستخدام بدءاً من 0.75$ لكل ألف طلب، والأرصدة صالحة لمدة 12 شهراً.
- احصل على مفتاح API المجاني ←
- تفضّل الدفع بالبطاقة؟ يتوفر serp.cheap أيضاً على RapidAPI (~0.90$ لكل ألف) وApify (~1.50$ لكل ألف).