Parámetros de búsqueda
Envía los parámetros como un cuerpo JSON a POST /v1/search. Solo q es obligatorio.
| Campo | Tipo | Por defecto | Descripción |
|---|---|---|---|
q | string (1–500) | — | Obligatorio. La consulta de búsqueda. |
gl | enum | us | Edición de país (ver abajo). |
hl | string | predeterminado del país | Idioma de la UI / de los resultados, BCP-47 (p. ej. en, pt-BR). |
tbs | enum | todo el tiempo | Filtro de tiempo: qdr:h (última hora), qdr:d (día), qdr:w (semana). |
page | integer (1–99) | 1 | Página de resultados (con índice base 1; ~10 resultados orgánicos cada una). |
freshness | enum | default | Control de caché: default, realtime (forzar fresco), cached. Consulta Caché. |
deadline_ms | integer (1000–30000) | 15000 | Timeout por petición en milisegundos. |
Países (gl)
Sección titulada «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 tiempo (tbs)
Sección titulada «Filtro de tiempo (tbs)»Restringe los resultados a contenido reciente — ideal para noticias y temas en tendencia.
{ "q": "nvidia earnings", "tbs": "qdr:d" }Paginación (page)
Sección titulada «Paginación (page)»Cada página devuelve aproximadamente 10 resultados orgánicos. Solicita páginas 1–99; para recopilar los primeros 100 resultados,
recorre las páginas 1–10. Los SDKs exponen ayudantes (searchPages / search_pages) que iteran las páginas
por ti.