Per impostazione predefinita una Google Search API restituisce ogni volta gli stessi risultati evergreen. Quando segui notizie, trend o temi dell’ultimo minuto, vuoi solo pagine recenti — ed è esattamente ciò che fa il filtro temporale tbs. Rispecchia il menu Strumenti → Ultima ora / giorno / settimana dell’interfaccia di Google.
Il parametro tbs
Aggiungi tbs al body della richiesta con un valore qdr (query date range):
| Valore | Finestra |
|---|---|
qdr:h | Ultima ora |
qdr:d | Ultimo giorno |
qdr:w | Ultima settimana |
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"}'
Questo restituisce solo pagine indicizzate da Google nell’ultimo giorno — niente articoli evergreen obsoleti che soffocano le notizie.
Un monitor di notizie in poche righe
Interroga a intervalli regolari e avrai un leggero sistema di allerta. Eccolo 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
Sostituisci qdr:h con qdr:d/qdr:w per allargare la finestra. È la spina dorsale del monitoraggio di brand e concorrenti.
A cosa serve
- Monitoraggio notizie e PR — cogli le menzioni entro l’ora.
- Rilevamento dei trend — alimenta risultati freschi in un agente di ricerca AI così ragiona su ciò che sta accadendo ora.
- SEO su contenuti freschi — vedi chi si posiziona per un tema questa settimana, non chi si posizionava anni fa.
- Cambi di prezzo e prodotto — combina con il monitoraggio dei prezzi per individuare rapidamente nuove inserzioni.
Combina con altri parametri
tbs si combina con tutto il resto — paese, lingua, paginazione:
-d '{"q":"élections","gl":"fr","hl":"fr","tbs":"qdr:w","page":1}'
Sono risultati francesi recenti, in francese. Vedi il riferimento completo dei parametri e la SEO locale per paese.
Avanti
- Parametri della Google Search API spiegati
- Monitoraggio SERP dei concorrenti
- Google Search API per agenti AI
Prova serp.cheap
Inizia oggi a recuperare risultati freschi, filtrati per data. 100 ricerche gratis all’iscrizione — nessuna carta richiesta; pay-as-you-go da $0,75/1k dopo, e i crediti restano validi per 12 mesi.
- Ottieni la tua chiave API gratuita →
- Preferisci pagare con carta? serp.cheap è anche su RapidAPI (
$0,90/1k) e Apify ($1,50/1k).