Obtenir les bons résultats d’une API Google Search dépend surtout des paramètres. Voici la référence complète, avec serp.cheap.
Tous les paramètres
| Paramètre | Type | Défaut | Rôle |
|---|---|---|---|
q | string | requis | La requête de recherche |
gl | string | "us" | Pays des résultats (géolocalisation) |
hl | string | défaut du pays | Langue d’affichage/interface |
page | int | 1 | Page de résultats (indexée à partir de 1) |
tbs | string | aucun | Filtre temporel (qdr:h/qdr:d/qdr:w) |
gl — pays (celui que vous utiliserez le plus)
gl décide quel Google vous interrogez et quels classements régionaux vous obtenez. Pris en charge : us, br, gb, de, fr, es, it, mx, ca, au, jp, nl.
-d '{"q": "beste elektroautos", "gl": "de"}' # Allemagne
-d '{"q": "melhores carros elétricos", "gl": "br"}' # Brésilhl — surcharge de la langue
gl définit déjà une langue par défaut pertinente. N’utilisez hl que lorsque vous voulez des résultats dans une langue différente de celle par défaut du pays :
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Canada, en françaistbs — filtre temporel
Limitez aux résultats récents — parfait pour les actualités, la surveillance et les sujets tendances :
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # dernières 24 heures| Valeur | Fenêtre |
|---|---|
qdr:h | Dernière heure |
qdr:d | Dernier jour |
qdr:w | Dernière semaine |
page — pagination
Indexée à partir de 1 ; chaque page est une requête facturée séparément. Voir obtenir 100 résultats.
En combinant le tout
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"q": "mortgage rates", "gl": "us", "hl": "en", "page": 1, "tbs": "qdr:w"}'