Parametry wyszukiwania
Wysyłaj parametry jako treść JSON do POST /v1/search. Wymagane jest tylko q.
| Pole | Typ | Domyślnie | Opis |
|---|---|---|---|
q | string (1–500) | — | Wymagane. Zapytanie wyszukiwania. |
gl | enum | us | Edycja krajowa (zobacz poniżej). |
hl | string | domyślnie dla kraju | Język interfejsu / wyników, BCP-47 (np. en, pt-BR). |
tbs | enum | cały czas | Filtr czasu: qdr:h (ostatnia godzina), qdr:d (dzień), qdr:w (tydzień). |
page | integer (1–99) | 1 | Strona wyników (indeksowana od 1; ~10 wyników organicznych każda). |
freshness | enum | default | Kontrola cache: default, realtime (wymuś świeże), cached. Zobacz Buforowanie. |
deadline_ms | integer (1000–30000) | 15000 | Limit czasu na żądanie w milisekundach. |
Kraje (gl)
Dział zatytułowany „Kraje (gl)”br, us, gb, de, fr, es, it, mx, ca, au, jp, nl.
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }Filtr czasu (tbs)
Dział zatytułowany „Filtr czasu (tbs)”Ogranicz wyniki do niedawnej treści — idealne dla wiadomości i tematów na czasie.
{ "q": "nvidia earnings", "tbs": "qdr:d" }Paginacja (page)
Dział zatytułowany „Paginacja (page)”Każda strona zwraca mniej więcej 10 wyników organicznych. Żądaj stron 1–99; aby zebrać pierwsze 100 wyników,
przejdź pętlą strony 1–10. SDK udostępniają pomocniki (searchPages / search_pages), które iterują strony
za Ciebie.