← Torna al blog

Come Usare una Google Search API nel 2026: Guida Completa

Impara a usare una Google Search API dall'inizio alla fine — auth, parametri, parsing, paginazione e controllo costi — con codice Python, Node.js e curl.

2 min di lettura

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
ParametroDefaultDescrizione
qobbligatorioLa query di ricerca
gl"us"Paese (es. br, gb, de)
hldefault del paeseOverride della lingua dell’interfaccia
page1Pagina dei risultati (a partire da 1)
tbsnessunoFiltro 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

  1. Le cache hit costano metà — non forzare richieste fresh per query ripetute.
  2. Pagina in modo lazy.
  3. Scegli gl con precisione per evitare ripetizioni.

Prossimi passi

Frequently asked questions

Come chiamo una Google Search API?+

Invia una richiesta POST autenticata con la tua query. Con serp.cheap: POST https://api.serp.cheap/v1/search, header X-API-Key, body JSON come {"q": "...", "gl": "us"}. La risposta è JSON con un array organic[] di risultati.

Posso chiamare una Google Search API dal browser?+

No — non esporre mai la tua API key nel codice lato client. Inoltra sempre le richieste attraverso il tuo backend in modo che la chiave resti segreta.

Come mantengo bassi i costi della Google Search API?+

Appoggiati al caching (le query ripetute vengono servite a metà prezzo su serp.cheap), recupera le pagine aggiuntive solo quando necessario e tieni traccia di stats.cost per ogni chiamata.

Ottieni la tua chiave API

Più economico diretto, paga con carta o crypto, senza KYC. O tramite un marketplace.