Paramètres de recherche
Envoyez les paramètres dans un corps JSON à POST /v1/search. Seul q est requis.
| Champ | Type | Défaut | Description |
|---|---|---|---|
q | chaîne (1–500) | — | Requis. La requête de recherche. |
gl | enum | us | Édition pays (voir ci-dessous). |
hl | chaîne | défaut du pays | Langue de l’interface / des résultats, BCP-47 (par ex. en, pt-BR). |
tbs | enum | toute période | Filtre temporel : qdr:h (dernière heure), qdr:d (jour), qdr:w (semaine). |
page | entier (1–99) | 1 | Page de résultats (indexée à partir de 1 ; ~10 résultats organiques chacune). |
freshness | enum | default | Contrôle du cache : default, realtime (forcer le frais), cached. Voir Cache. |
deadline_ms | entier (1000–30000) | 15000 | Timeout par requête en millisecondes. |
Pays (gl)
Section intitulée « Pays (gl) »br, us, gb, de, fr, es, it, mx, ca, au, jp, nl.
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }Filtre temporel (tbs)
Section intitulée « Filtre temporel (tbs) »Limitez les résultats au contenu récent — idéal pour l’actualité et les sujets tendance.
{ "q": "nvidia earnings", "tbs": "qdr:d" }Pagination (page)
Section intitulée « Pagination (page) »Chaque page renvoie environ 10 résultats organiques. Demandez les pages 1–99 ; pour collecter les 100 premiers résultats,
parcourez les pages 1 à 10. Les SDK exposent des helpers (searchPages / search_pages) qui itèrent les pages
pour vous.