Arama parametreleri
Parametreleri POST /v1/search adresine JSON gövdesi olarak gönderin. Yalnızca q zorunludur.
| Alan | Tür | Varsayılan | Açıklama |
|---|---|---|---|
q | string (1–500) | — | Zorunlu. Arama sorgusu. |
gl | enum | us | Ülke sürümü (aşağıya bakın). |
hl | string | ülke varsayılanı | Arayüz / sonuç dili, BCP-47 (ör. en, pt-BR). |
tbs | enum | tüm zamanlar | Zaman filtresi: qdr:h (son saat), qdr:d (gün), qdr:w (hafta). |
page | integer (1–99) | 1 | Sonuç sayfası (1’den başlar; her biri ~10 organik sonuç). |
freshness | enum | default | Önbellek kontrolü: default, realtime (taze zorla), cached. Bkz. Önbellekleme. |
deadline_ms | integer (1000–30000) | 15000 | Milisaniye cinsinden istek başına zaman aşımı. |
Ülkeler (gl)
Bölüm başlığı “Ülkeler (gl)”br, us, gb, de, fr, es, it, mx, ca, au, jp, nl.
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }Zaman filtresi (tbs)
Bölüm başlığı “Zaman filtresi (tbs)”Sonuçları yakın zamanlı içerikle sınırlayın — haberler ve gündemdeki konular için idealdir.
{ "q": "nvidia earnings", "tbs": "qdr:d" }Sayfalama (page)
Bölüm başlığı “Sayfalama (page)”Her sayfa yaklaşık 10 organik sonuç döndürür. 1–99 arasında sayfa isteyin; ilk 100 sonucu toplamak için
1–10 arası sayfaları döngüleyin. SDK’ler sayfaları sizin için yineleyen yardımcılar (searchPages / search_pages)
sunar.