De juiste resultaten uit een Google Search API halen draait vooral om de parameters. Hier is de complete referentie, met serp.cheap.
Alle parameters
| Parameter | Type | Standaard | Wat het doet |
|---|---|---|---|
q | string | vereist | De zoekopdracht |
gl | string | "us" | Land van de resultaten (geolocatie) |
hl | string | landstandaard | Weergave-/interfacetaal |
page | int | 1 | Resultatenpagina (1-geïndexeerd) |
tbs | string | geen | Tijdfilter (qdr:h/qdr:d/qdr:w) |
gl — land (degene die je het meest gebruikt)
gl bepaalt welk Google je aanspreekt en welke regionale rankings je krijgt. Ondersteund: 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"}' # Brazil
hl — taaloverschrijving
gl stelt al een passende standaardtaal in. Gebruik hl alleen als je resultaten in een andere taal wilt dan de standaardtaal van het land:
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Canada, in French
tbs — tijdfilter
Beperk tot recente resultaten — geweldig voor nieuws, monitoring en trending onderwerpen:
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # past 24 hours
| Waarde | Venster |
|---|---|
qdr:h | Afgelopen uur |
qdr:d | Afgelopen dag |
qdr:w | Afgelopen week |
page — paginering
1-geïndexeerd; elke pagina is een afzonderlijk gefactureerd verzoek. Zie 100 resultaten ophalen.
Alles samen
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"}'