Par défaut, une API Google Search renvoie à chaque fois les mêmes résultats intemporels. Quand vous suivez de l’actualité, des tendances ou des sujets brûlants, vous ne voulez que des pages récentes — et c’est exactement ce que fait le filtre temporel tbs. Il reproduit le menu Outils → Dernière heure / jour / semaine de l’interface Google.
Le paramètre tbs
Ajoutez tbs au corps de la requête avec une valeur qdr (query date range) :
| Valeur | Fenêtre |
|---|---|
qdr:h | Dernière heure |
qdr:d | Dernières 24 heures |
qdr:w | Dernière semaine |
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"}'
Cela ne renvoie que les pages indexées par Google au cours des dernières 24 heures — aucun article intemporel périmé ne vient noyer l’actualité.
Un moniteur d’actualité en quelques lignes
Interrogez l’API à intervalles réguliers et vous obtenez un système d’alerte léger. Le voici en 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) # toutes les 10 minutes
Remplacez qdr:h par qdr:d/qdr:w pour élargir la fenêtre. C’est la colonne vertébrale de la veille de marque et de concurrents.
À quoi ça sert
- Veille d’actualité et de RP — repérez les mentions dans l’heure.
- Détection de tendances — alimentez un agent de recherche IA avec des résultats frais pour qu’il raisonne sur ce qui se passe maintenant.
- SEO de contenu frais — voyez qui se classe sur un sujet cette semaine, pas qui se classait il y a des années.
- Changements de prix et de produits — combinez-le avec le suivi des prix pour repérer rapidement les nouvelles annonces.
Combiner avec d’autres paramètres
tbs se cumule avec tout le reste — pays, langue, pagination :
-d '{"q":"élections","gl":"fr","hl":"fr","tbs":"qdr:w","page":1}'
Voilà des résultats français récents, en français. Voir la référence complète des paramètres et le SEO local par pays.
Suite
- Les paramètres de l’API Google Search expliqués
- Veille SERP des concurrents
- API Google Search pour les agents IA
Essayez serp.cheap
Commencez dès aujourd’hui à récupérer des résultats frais et filtrés par date. 100 recherches gratuites à l’inscription — sans carte bancaire ; puis paiement à l’usage dès 0,75 $/1k, et les crédits restent valables 12 mois.
- Obtenez votre clé API gratuite →
- Vous préférez payer par carte ? serp.cheap est aussi disponible sur RapidAPI (~0,90 $/1k) et Apify (~1,50 $/1k).