Parametri di ricerca
Invia i parametri come corpo JSON a POST /v1/search. Solo q è obbligatorio.
| Campo | Tipo | Default | Descrizione |
|---|---|---|---|
q | string (1–500) | — | Obbligatorio. La query di ricerca. |
gl | enum | us | Edizione paese (vedi sotto). |
hl | string | default del paese | Lingua dell’interfaccia / dei risultati, BCP-47 (es. en, pt-BR). |
tbs | enum | tutto il tempo | Filtro temporale: qdr:h (ultima ora), qdr:d (giorno), qdr:w (settimana). |
page | integer (1–99) | 1 | Pagina dei risultati (1-indexed; ~10 risultati organici ciascuna). |
freshness | enum | default | Controllo cache: default, realtime (forza fresco), cached. Vedi Caching. |
deadline_ms | integer (1000–30000) | 15000 | Timeout per richiesta in millisecondi. |
Paesi (gl)
Sezione intitolata “Paesi (gl)”br, us, gb, de, fr, es, it, mx, ca, au, jp, nl.
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }Filtro temporale (tbs)
Sezione intitolata “Filtro temporale (tbs)”Limita i risultati ai contenuti recenti — ideale per notizie e argomenti di tendenza.
{ "q": "nvidia earnings", "tbs": "qdr:d" }Paginazione (page)
Sezione intitolata “Paginazione (page)”Ogni pagina restituisce circa 10 risultati organici. Richiedi le pagine 1–99; per raccogliere i primi 100 risultati,
itera le pagine 1–10. Gli SDK espongono helper (searchPages / search_pages) che iterano le pagine
per te.