Ottenere i risultati giusti da una Google Search API dipende soprattutto dai parametri. Ecco il riferimento completo, usando serp.cheap.
Tutti i parametri
| Parametro | Tipo | Predefinito | Cosa fa |
|---|---|---|---|
q | string | obbligatorio | La query di ricerca |
gl | string | "us" | Paese dei risultati (geo-localizzazione) |
hl | string | predefinito del paese | Lingua di visualizzazione/interfaccia |
page | int | 1 | Pagina dei risultati (indicizzata da 1) |
tbs | string | nessuno | Filtro temporale (qdr:h/qdr:d/qdr:w) |
gl — paese (quello che userai di più)
gl decide quale Google contatti e quali ranking regionali ottieni. Supportati: us, br, gb, de, fr, es, it, mx, ca, au, jp, nl.
-d '{"q": "beste elektroautos", "gl": "de"}' # Germania
-d '{"q": "melhores carros elétricos", "gl": "br"}' # Brasilehl — override della lingua
gl imposta già una lingua predefinita sensata. Usa hl solo quando vuoi risultati in una lingua diversa da quella predefinita del paese:
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Canada, in francesetbs — filtro temporale
Limita ai risultati recenti — ottimo per notizie, monitoraggio e argomenti di tendenza:
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # ultime 24 ore| Valore | Finestra |
|---|---|
qdr:h | Ultima ora |
qdr:d | Ultimo giorno |
qdr:w | Ultima settimana |
page — paginazione
Indicizzata da 1; ogni pagina è una richiesta fatturata separatamente. Vedi come ottenere 100 risultati.
Mettendo tutto insieme
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"q": "mortgage rates", "gl": "us", "hl": "en", "page": 1, "tbs": "qdr:w"}'