البدء السريع

يحوّل serp.cheap عملية بحث Google إلى JSON نظيف عبر نقطة وصول HTTPS واحدة.

• عنوان URL الأساسي: https://api.serp.cheap
• نقطة الوصول: POST /v1/search
• المصادقة: ترويسة x-api-key

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

سجّل الدخول من app.serp.cheap وأنشئ مفتاحاً. يبدأ كل حساب جديد برصيد مجاني.

2. أرسِل طلباً

أرسل استعلامك بصيغة JSON مع مفتاحك في ترويسة x-api-key.

curl

curl -X POST https://api.serp.cheap/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "q": "best running shoes", "gl": "us" }'

JavaScript

import { SerpCheap } from "@serpcheap/sdk";

const client = new SerpCheap("YOUR_API_KEY");
const res = await client.search({ q: "best running shoes", gl: "us" });
console.log(res.organic[0].title);

Python

from serpcheap import SerpCheap

client = SerpCheap("YOUR_API_KEY")
res = client.search(q="best running shoes", gl="us")
print(res.organic[0].title)

3. اقرأ الاستجابة

تعود النتائج مرتّبة، مع Knowledge Graph اختياري وإحصاءات الفوترة.

{
  "search": "best running shoes",
  "page": 1,
  "organic": [
    {
      "position": 1,
      "title": "The 10 Best Running Shoes of 2026",
      "link": "https://example.com/best-running-shoes",
      "snippet": "Our running experts tested 40+ pairs…"
    }
  ],
  "knowledgeGraph": { "title": "Running shoe", "description": "…" },
  "stats": { "balance": 9994, "cost": 6, "cached": false }
}

بحث واحد = جلب حديث واحد

يكلّف الجلب الحديث 6 وحدات رصيد؛ بينما تكلّف نتيجة الذاكرة المؤقتة 3. يخبرك stats.cost بدقة بما تمت فوترته في كل استدعاء، وstats.balance هو رصيدك المتبقي. راجع التسعير والرصيد.

الخطوات التالية

• المصادقة — المفاتيح والترويسات وأخطاء المصادقة.
• معاملات البحث — الدولة واللغة وفلاتر الوقت والترقيم.
• بنية الاستجابة — النتائج العضوية والإعلانات وKnowledge Graph وعمليات البحث ذات الصلة.
• حزم SDK — مكتبات رسمية لـ JS وPython وGo وRust وJava.