تُرجع Google نحو 10 نتائج عضوية لكل صفحة. لجمع حتى 100 نتيجة، تتصفح النتائج باستخدام المعامل page. إليك كيفية القيام بذلك بكفاءة مع serp.cheap.
الأساسيات
- يبدأ ترقيم
pageمن 1 (1= الصفحة الأولى). - تُرجع كل صفحة نحو 10 نتائج عضوية.
- كل صفحة هي طلب منفصل تُحتسب تكلفته — لذا 100 نتيجة ≈ 10 طلبات.
Python: جمع حتى 100 نتيجة
import requests
def fetch_results(q, gl="us", max_results=100):
out, page = [], 1
while len(out) < max_results:
r = requests.post(
"https://api.serp.cheap/v1/search",
headers={"X-API-Key": "YOUR_KEY"},
json={"q": q, "gl": gl, "page": page},
timeout=30,
)
r.raise_for_status()
batch = r.json()["organic"]
if not batch:
break # no more results
out += batch
page += 1
return out[:max_results]
results = fetch_results("best project management software")
print(len(results), "results")Node.js
async function fetchResults(q, max = 100) {
const out = [];
for (let page = 1; out.length < max; page++) {
const res = await fetch("https://api.serp.cheap/v1/search", {
method: "POST",
headers: { "X-API-Key": process.env.SERP_KEY, "Content-Type": "application/json" },
body: JSON.stringify({ q, gl: "us", page }),
});
const { organic } = await res.json();
if (!organic.length) break;
out.push(...organic);
}
return out.slice(0, max);
}نصائح
- أزل التكرار حسب الرابط إذا دمجت الصفحات — قد يحدث تداخل أحيانًا.
- توقف مبكرًا عندما تُرجع صفحة لا نتائج فيها.
- اجلب بكسل — لا تسحب 100 نتيجة إذا كنت تعرض 10 فقط. التكلفة تتناسب مع عدد الصفحات.