O Google retorna ~10 resultados orgânicos por página. Para coletar até 100, você pagina pelos resultados com o parâmetro page. Veja como fazer isso de forma eficiente com o serp.cheap.
O básico
pagecomeça em 1 (1= primeira página).- Cada página retorna ~10 resultados orgânicos.
- Cada página é uma requisição cobrada separadamente — então 100 resultados ≈ 10 requisições.
Python: coletar até 100 resultados
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);
}Dicas
- Deduplique por link se você juntar páginas — sobreposições ocasionais podem ocorrer.
- Pare cedo quando uma página não retornar resultados.
- Busque de forma lazy — não puxe 100 resultados se você só exibe 10. O custo escala com as páginas.