Standaard geeft een Google Search API elke keer dezelfde evergreen-resultaten terug. Wanneer je nieuws, trends of breaking topics volgt, wil je alleen recente pagina’s — en dat is precies wat het tbs-tijdfilter doet. Het weerspiegelt het menu Tools → Afgelopen uur / dag / week in de Google-UI.
De tbs-parameter
Voeg tbs toe aan de request-body met een qdr-waarde (query date range):
| Waarde | Venster |
|---|---|
qdr:h | Afgelopen uur |
qdr:d | Afgelopen dag |
qdr:w | Afgelopen week |
curl -X POST https://api.serp.cheap/v1/search \
-H "X-API-Key: $SERP_CHEAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"openai announcement","gl":"us","tbs":"qdr:d"}'
Dat geeft alleen pagina’s terug die Google in de afgelopen dag heeft geïndexeerd — geen verouderde evergreen-artikelen die het nieuws verdringen.
Een nieuwsmonitor in een paar regels
Poll op een schema en je hebt een lichtgewicht alerteringssysteem. Hier is het in Python:
import requests, time
def recent(query, window="qdr:h"):
r = requests.post(
"https://api.serp.cheap/v1/search",
headers={"X-API-Key": KEY},
json={"q": query, "gl": "us", "tbs": window},
)
return r.json().get("organic", [])
seen = set()
while True:
for hit in recent('"your brand"'):
if hit["link"] not in seen:
seen.add(hit["link"])
print("NEW:", hit["title"], hit["link"])
time.sleep(600) # every 10 minutes
Vervang qdr:h door qdr:d/qdr:w om het venster te verbreden. Dit is de ruggengraat van brand- en concurrentiemonitoring.
Waar het goed voor is
- Nieuws- & PR-monitoring — vang vermeldingen binnen het uur op.
- Trenddetectie — voed verse resultaten aan een AI-onderzoeksagent zodat die redeneert over wat er nu gebeurt.
- Verse-content-SEO — zie wie deze week rankt voor een onderwerp, niet wie jaren geleden rankte.
- Prijs- & productwijzigingen — combineer met prijsmonitoring om nieuwe listings snel op te sporen.
Combineer met andere parameters
tbs stapelt met al het andere — land, taal, paginering:
-d '{"q":"élections","gl":"fr","hl":"fr","tbs":"qdr:w","page":1}'
Dat zijn recente Franse resultaten, in het Frans. Zie de volledige parameterreferentie en lokale SEO per land.
Volgende
Probeer serp.cheap
Begin vandaag met het ophalen van verse, op tijd gefilterde resultaten. 100 gratis zoekopdrachten bij aanmelding — geen creditcard nodig; daarna pay-as-you-go vanaf $0,75/1k, en credits blijven 12 maanden geldig.
- Vraag je gratis API-key aan →
- Liever met kaart betalen? serp.cheap staat ook op RapidAPI (
$0,90/1k) en Apify ($1,50/1k).