← Torna al blog

Google Search API con curl: Guida rapida (2026)

Chiama una Google Search API dalla riga di comando con curl — auth, parametri di paese e filtro temporale, paginazione e pipe del JSON a jq.

1 min di lettura

Il modo più veloce per testare una Google Search API è dal tuo terminale. Gli esempi usano serp.cheap.

Richiesta di base

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}'

Filtri di paese e temporali

# Risultati dal Brasile, ultime 24 ore
curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "eleições", "gl": "br", "tbs": "qdr:d"}'

Vedi tutte le opzioni in parametri della Google Search API.

Formattazione leggibile ed estrazione con jq

# Solo i link organici
curl -s https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "serp api curl", "gl": "us"}' | jq -r '.organic[].link'

# Titolo + link come TSV
... | jq -r '.organic[] | [.position, .title, .link] | @tsv'

# Quanto è costata questa chiamata?
... | jq '.stats'

Paginazione

for p in 1 2 3; do
  curl -s https://api.serp.cheap/v1/search \
    -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
    -d "{\"q\": \"serp api\", \"page\": $p}" | jq -r '.organic[].link'
done

Tieni la tua chiave in una variabile d’ambiente (-H "X-API-Key: $SERP_KEY") invece di incollarla negli script.

Avanti

Frequently asked questions

Come testo una Google Search API con curl?+

Invia in POST un body JSON con la tua chiave nell'header: curl https://api.serp.cheap/v1/search -H 'X-API-Key: KEY' -H 'Content-Type: application/json' -d '{"q":"...","gl":"us"}'.

Come estraggo solo i link?+

Fai il pipe della risposta a jq: ... | jq -r '.organic[].link'.

Ottieni la tua chiave API

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