Standardmäßig liefert eine Google Search API jedes Mal dieselben zeitlosen Ergebnisse. Wenn du News, Trends oder aktuelle Themen verfolgst, willst du nur aktuelle Seiten — und genau das leistet der tbs-Zeitfilter. Er bildet das Menü Tools → Letzte Stunde / Tag / Woche in der Google-Oberfläche nach.
Der tbs-Parameter
Füge dem Anfrage-Body tbs mit einem qdr-Wert (query date range) hinzu:
| Wert | Zeitfenster |
|---|---|
qdr:h | Letzte Stunde |
qdr:d | Letzter Tag |
qdr:w | Letzte Woche |
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"}'
Das liefert nur Seiten, die Google im letzten Tag indexiert hat — keine veralteten Evergreen-Artikel, die die News verdrängen.
Ein News-Monitor in wenigen Zeilen
Rufe planmäßig ab und du hast ein leichtgewichtiges Alerting-System. Hier 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
Tausche qdr:h gegen qdr:d/qdr:w, um das Zeitfenster zu erweitern. Das ist das Rückgrat von Brand- und Wettbewerber-Monitoring.
Wofür es gut ist
- News- & PR-Monitoring — erfasse Erwähnungen innerhalb der Stunde.
- Trend-Erkennung — speise frische Ergebnisse in einen KI-Recherche-Agenten ein, damit er über das nachdenkt, was gerade jetzt passiert.
- SEO für frische Inhalte — sieh, wer diese Woche für ein Thema rankt, nicht wer vor Jahren rankte.
- Preis- & Produktänderungen — kombiniere es mit Preis-Monitoring, um neue Listings schnell zu entdecken.
Mit anderen Parametern kombinieren
tbs lässt sich mit allem anderen stapeln — Land, Sprache, Paginierung:
-d '{"q":"élections","gl":"fr","hl":"fr","tbs":"qdr:w","page":1}'
Das sind aktuelle französische Ergebnisse, auf Französisch. Siehe die vollständige Parameterreferenz und lokales SEO nach Land.
Weiter
serp.cheap ausprobieren
Beginne noch heute damit, frische, zeitgefilterte Ergebnisse abzurufen. 100 Suchen gratis bei der Anmeldung — keine Kreditkarte nötig; danach Pay-as-you-go ab 0,75 $/1.000, und Credits bleiben 12 Monate gültig.
- Hol dir deinen kostenlosen API-Schlüssel →
- Lieber per Karte zahlen? serp.cheap ist auch auf RapidAPI (~0,90 $/1.000) und Apify (~1,50 $/1.000) verfügbar.