Questa è la guida pratica e completa all’uso di una Google Search API: autenticarsi, inviare una query, leggere il JSON, paginare, gestire gli errori e contenere i costi. Gli esempi usano serp.cheap (l’opzione più economica nel 2026), ma i concetti valgono per qualsiasi SERP API.
1. Ottieni una API key
Registrati gratis direttamente su app.serp.cheap/login — 100 ricerche gratuite, senza carta di credito. In alternativa puoi partire da Apify o RapidAPI. In ogni caso ottieni una chiave da passare nell’header X-API-Key. I crediti restano validi per 12 mesi.
2. L’endpoint in una riga
POST https://api.serp.cheap/v1/search
| Parametro | Default | Descrizione |
|---|---|---|
q | obbligatorio | La query di ricerca |
gl | "us" | Paese (es. br, gb, de) |
hl | default del paese | Override della lingua dell’interfaccia |
page | 1 | Pagina dei risultati (a partire da 1) |
tbs | nessuno | Filtro temporale: qdr:h, qdr:d, qdr:w |
Riferimento completo: parametri della Google Search API.
3. La tua prima richiesta
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"])
Guide per linguaggio specifico: Python · Node.js · PHP · Go · curl.
4. Leggi la risposta
{
"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 è espresso in crediti (1 credito = $0.0001). Una richiesta fresh costa 6 crediti ($0.0006); una cache hit ne costa 3 ($0.0003). stats.cached indica quale percorso hai ottenuto.
5. Paginazione
Ogni pagina è una richiesta separata — incrementa page. Recupera la pagina 2+ solo quando un utente ne ha effettivamente bisogno. Vedi ottenere 100 risultati.
6. Gestione degli errori
- 401 — API key errata/mancante.
- 402 — crediti esauriti; ricarica.
- 429 — rate limit (tier gratuito 60 req/min = 1 req/s, pay-as-you-go 600 req/min = 10 req/s, fino a 60 req/s sui piani superiori); attendi e riprova.
- 5xx — transitorio; riprova con backoff esponenziale.
Avvolgi sempre le chiamate in un retry con backoff per 429/5xx.
7. Mantienilo economico
- Le cache hit costano metà — non forzare richieste fresh per query ripetute.
- Pagina in modo lazy.
- Scegli
glcon precisione per evitare ripetizioni.
Prossimi passi
-
Costruisci qualcosa di reale: un rank tracker in Python o Google Search per agenti AI.
-
Confronta i provider: SERP API più economica 2026.
-
Registrati gratis su serp.cheap → — 100 ricerche gratuite, nessuna carta richiesta