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
-
Guida completa: come usare la Google Search API