Die richtigen Ergebnisse aus einer Google Search API zu bekommen, hängt vor allem von den Parametern ab. Hier ist die komplette Referenz, mit serp.cheap.
Alle Parameter
| Parameter | Typ | Standard | Was er bewirkt |
|---|---|---|---|
q | string | erforderlich | Die Suchanfrage |
gl | string | "us" | Land der Ergebnisse (Geolokalisierung) |
hl | string | Standard des Landes | Anzeige-/Oberflächensprache |
page | int | 1 | Ergebnisseite (1-indiziert) |
tbs | string | keiner | Zeitfilter (qdr:h/qdr:d/qdr:w) |
gl — Land (der Parameter, den du am häufigsten nutzt)
gl entscheidet, welches Google du ansprichst und welche regionalen Rankings du bekommst. Unterstützt: us, br, gb, de, fr, es, it, mx, ca, au, jp, nl.
-d '{"q": "beste elektroautos", "gl": "de"}' # Germany
-d '{"q": "melhores carros elétricos", "gl": "br"}' # Brazilhl — Sprachüberschreibung
gl setzt bereits eine sinnvolle Standardsprache. Nutze hl nur, wenn du Ergebnisse in einer anderen Sprache als der Standardsprache des Landes möchtest:
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Canada, in Frenchtbs — Zeitfilter
Beschränke auf aktuelle Ergebnisse — ideal für News, Monitoring und Trendthemen:
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # past 24 hours| Wert | Zeitfenster |
|---|---|
qdr:h | Letzte Stunde |
qdr:d | Letzter Tag |
qdr:w | Letzte Woche |
page — Paginierung
1-indiziert; jede Seite ist eine separat abgerechnete Anfrage. Siehe 100 Ergebnisse erhalten.
Alles zusammen
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"}'