Domyślnie Google Search API za każdym razem zwraca te same ponadczasowe wyniki. Gdy śledzisz newsy, trendy lub gorące tematy, chcesz tylko najnowszych stron — i dokładnie to robi filtr czasu tbs. Odzwierciedla on menu Narzędzia → Ostatnia godzina / dzień / tydzień w interfejsie Google.
Parametr tbs
Dodaj tbs do treści żądania z wartością qdr (query date range):
| Wartość | Okno |
|---|---|
qdr:h | Ostatnia godzina |
qdr:d | Ostatni dzień |
qdr:w | Ostatni tydzień |
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"}'To zwraca tylko strony, które Google zindeksował w ostatnim dniu — bez przestarzałych ponadczasowych artykułów wypierających newsy.
Monitor newsów w kilku linijkach
Odpytuj według harmonogramu, a masz lekki system alertów. Oto on w Pythonie:
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 minutesZamień qdr:h na qdr:d/qdr:w, aby poszerzyć okno. To trzon monitorowania marki i konkurencji.
Do czego się przydaje
- Monitorowanie newsów i PR — wychwyć wzmianki w ciągu godziny.
- Wykrywanie trendów — podawaj świeże wyniki do agenta badawczego AI, aby wnioskował o tym, co dzieje się teraz.
- SEO świeżych treści — zobacz, kto rankuje na dany temat w tym tygodniu, a nie kto rankował lata temu.
- Zmiany cen i produktów — połącz z monitorowaniem cen, aby szybko wychwycić nowe oferty.
Łącz z innymi parametrami
tbs łączy się ze wszystkim innym — krajem, językiem, paginacją:
-d '{"q":"élections","gl":"fr","hl":"fr","tbs":"qdr:w","page":1}'To najnowsze francuskie wyniki, po francusku. Zobacz pełny opis parametrów i lokalne SEO według kraju.
Dalej
- Parametry Google Search API wyjaśnione
- Monitorowanie SERP konkurencji
- Google Search API dla agentów AI
Wypróbuj serp.cheap
Zacznij pobierać świeże, filtrowane po czasie wyniki już dziś. 100 darmowych wyszukiwań po rejestracji — bez karty; potem płatność za użycie od $0,75/1k, a kredyty pozostają ważne przez 12 miesięcy.
- Zdobądź darmowy klucz API →
- Wolisz płacić kartą? serp.cheap jest też na RapidAPI (
$0,90/1k) i Apify ($1,50/1k).