→ العودة إلى المدونة

واجهة بحث Google عبر curl: مرجع سريع (2026)

استدعِ واجهة بحث Google من سطر الأوامر باستخدام curl — المصادقة، معاملات الدولة والوقت، التصفّح، وتمرير JSON إلى jq.

1 دقيقة قراءة

أسرع طريقة لاختبار واجهة بحث Google هي من الطرفية لديك. تستخدم الأمثلة serp.cheap.

طلب أساسي

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}'

مرشّحات الدولة والوقت

# Results from Brazil, last 24 hours
curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "eleições", "gl": "br", "tbs": "qdr:d"}'

اطّلع على جميع الخيارات في معاملات واجهة بحث Google.

التنسيق والاستخراج باستخدام jq

# Just the organic links
curl -s https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "serp api curl", "gl": "us"}' | jq -r '.organic[].link'

# Title + link as TSV
... | jq -r '.organic[] | [.position, .title, .link] | @tsv'

# What did this call cost?
... | jq '.stats'

التصفّح عبر الصفحات

for p in 1 2 3; do
  curl -s https://api.serp.cheap/v1/search \
    -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
    -d "{\"q\": \"serp api\", \"page\": $p}" | jq -r '.organic[].link'
done

احتفظ بمفتاحك في متغيّر بيئة (-H "X-API-Key: $SERP_KEY") بدلاً من لصقه داخل النصوص البرمجية.

التالي

Frequently asked questions

كيف أختبر واجهة بحث Google باستخدام curl؟+

أرسل طلب POST بجسم JSON مع مفتاحك في الترويسة: curl https://api.serp.cheap/v1/search -H 'X-API-Key: KEY' -H 'Content-Type: application/json' -d '{"q":"...","gl":"us"}'.

كيف أستخرج الروابط فقط؟+

مرّر الاستجابة إلى jq: ... | jq -r '.organic[].link'.

احصل على مفتاح API

الأرخص مباشرة, ادفع ببطاقة أو عملات مشفّرة، بدون KYC. أو عبر سوق.