Uzyskanie właściwych wyników z Google Search API zależy głównie od parametrów. Oto kompletny przewodnik, na przykładzie serp.cheap.
Wszystkie parametry
| Parametr | Typ | Domyślnie | Co robi |
|---|---|---|---|
q | string | wymagany | Zapytanie wyszukiwania |
gl | string | "us" | Kraj wyników (geolokalizacja) |
hl | string | domyślny dla kraju | Język wyświetlania/interfejsu |
page | int | 1 | Strona wyników (indeksowana od 1) |
tbs | string | brak | Filtr czasu (qdr:h/qdr:d/qdr:w) |
gl — kraj (ten, którego użyjesz najczęściej)
gl decyduje, które Google odpytujesz i jakie regionalne rankingi otrzymujesz. Obsługiwane: us, br, gb, de, fr, es, it, mx, ca, au, jp, nl.
-d '{"q": "beste elektroautos", "gl": "de"}' # Niemcy
-d '{"q": "melhores carros elétricos", "gl": "br"}' # Brazyliahl — nadpisanie języka
gl już ustawia rozsądny język domyślny. Użyj hl tylko wtedy, gdy chcesz uzyskać wyniki w innym języku niż domyślny dla danego kraju:
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Kanada, po francuskutbs — filtr czasu
Ogranicz do najnowszych wyników — świetne do wiadomości, monitoringu i popularnych tematów:
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # ostatnie 24 godziny| Wartość | Okno |
|---|---|
qdr:h | Ostatnia godzina |
qdr:d | Ostatni dzień |
qdr:w | Ostatni tydzień |
page — paginacja
Indeksowana od 1; każda strona to osobne, płatne żądanie. Zobacz jak uzyskać 100 wyników.
Wszystko razem
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"q": "mortgage rates", "gl": "us", "hl": "en", "page": 1, "tbs": "qdr:w"}'