Parâmetros de busca
Envie os parâmetros como um corpo JSON para POST /v1/search. Apenas q é obrigatório.
| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
q | string (1–500) | — | Obrigatório. A consulta de busca. |
gl | enum | us | Edição de país (veja abaixo). |
hl | string | padrão do país | Idioma da interface / dos resultados, BCP-47 (ex.: en, pt-BR). |
tbs | enum | todo o período | Filtro de tempo: qdr:h (última hora), qdr:d (dia), qdr:w (semana). |
page | integer (1–99) | 1 | Página de resultados (indexada em 1; ~10 resultados orgânicos cada). |
freshness | enum | default | Controle de cache: default, realtime (força busca nova), cached. Veja Cache. |
deadline_ms | integer (1000–30000) | 15000 | Timeout por requisição em milissegundos. |
Países (gl)
Seção intitulada “Países (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 de tempo (tbs)
Seção intitulada “Filtro de tempo (tbs)”Restrinja os resultados a conteúdo recente — ideal para notícias e tópicos em alta.
{ "q": "nvidia earnings", "tbs": "qdr:d" }Paginação (page)
Seção intitulada “Paginação (page)”Cada página retorna aproximadamente 10 resultados orgânicos. Solicite as páginas 1–99; para coletar os primeiros 100 resultados,
percorra as páginas 1–10. Os SDKs expõem helpers (searchPages / search_pages) que iteram as páginas
para você.