Suchparameter
Sende Parameter als JSON-Body an POST /v1/search. Nur q ist erforderlich.
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
q | string (1–500) | — | Erforderlich. Die Suchanfrage. |
gl | enum | us | Länderversion (siehe unten). |
hl | string | Länderstandard | UI- / Ergebnissprache, BCP-47 (z. B. en, pt-BR). |
tbs | enum | gesamte Zeit | Zeitfilter: qdr:h (letzte Stunde), qdr:d (Tag), qdr:w (Woche). |
page | integer (1–99) | 1 | Ergebnisseite (1-indiziert; jeweils ~10 organische Ergebnisse). |
freshness | enum | default | Cache-Steuerung: default, realtime (frisch erzwingen), cached. Siehe Cache. |
deadline_ms | integer (1000–30000) | 15000 | Timeout pro Anfrage in Millisekunden. |
Länder (gl)
Abschnitt betitelt „Länder (gl)“br, us, gb, de, fr, es, it, mx, ca, au, jp, nl.
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }Zeitfilter (tbs)
Abschnitt betitelt „Zeitfilter (tbs)“Beschränke Ergebnisse auf aktuelle Inhalte — ideal für Nachrichten und Trendthemen.
{ "q": "nvidia earnings", "tbs": "qdr:d" }Paginierung (page)
Abschnitt betitelt „Paginierung (page)“Jede Seite liefert ungefähr 10 organische Ergebnisse. Fordere Seiten 1–99 an; um die ersten 100 Ergebnisse zu sammeln,
durchlaufe die Seiten 1–10. Die SDKs stellen Helfer (searchPages / search_pages) bereit, die die Seiten
für dich durchlaufen.