Voici le guide pratique et complet pour utiliser une API Google Search : s’authentifier, envoyer une requête, lire le JSON, paginer, gérer les erreurs et maîtriser les coûts. Les exemples utilisent serp.cheap (l’option la moins chère en 2026), mais les concepts s’appliquent à n’importe quelle API SERP.
1. Obtenir une clé API
Le plus simple : créez un compte gratuit sur app.serp.cheap/login — 100 recherches offertes, sans carte bancaire. Vous récupérez une clé que vous passez dans l’en-tête X-API-Key, et les crédits restent valables 12 mois. Vous préférez une place de marché ? serp.cheap est aussi disponible sur Apify et RapidAPI.
2. L’endpoint en une ligne
POST https://api.serp.cheap/v1/search
| Paramètre | Défaut | Description |
|---|---|---|
q | requis | La requête de recherche |
gl | "us" | Pays (par exemple br, gb, de) |
hl | défaut du pays | Surcharge de la langue de l’interface |
page | 1 | Page de résultats (indexée à partir de 1) |
tbs | aucun | Filtre temporel : qdr:h, qdr:d, qdr:w |
Référence complète : paramètres de l’API Google Search.
3. Votre première requête
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'
import requests
r = requests.post(
"https://api.serp.cheap/v1/search",
headers={"X-API-Key": "YOUR_KEY"},
json={"q": "best electric cars 2026", "gl": "us", "page": 1},
)
r.raise_for_status()
data = r.json()
for item in data["organic"]:
print(item["position"], item["title"], item["link"])
Guides par langage : Python · Node.js · PHP · Go · curl.
4. Lire la réponse
{
"search": "best electric cars 2026",
"page": 1,
"organic": [
{
"position": 1,
"title": "Best Electric Cars of 2026",
"link": "https://example.com/best-evs",
"snippet": "We tested every major EV...",
"date": "Jan 10, 2026"
}
],
"stats": { "balance": 99994, "cost": 6, "cached": false }
}
stats.cost est exprimé en crédits (1 crédit = 0,0001 $). Une récupération fraîche coûte 6 crédits (0,0006 $) ; un hit de cache en coûte 3 (0,0003 $). stats.cached vous indique quel chemin a été emprunté.
5. Pagination
Chaque page est une requête distincte — incrémentez page. Ne récupérez la page 2 et au-delà que lorsqu’un utilisateur en a réellement besoin. Voir obtenir 100 résultats.
6. Gestion des erreurs
- 401 — clé API incorrecte ou manquante.
- 402 — crédits épuisés ; rechargez.
- 429 — limite de débit atteinte (60 req/min sur l’offre gratuite, 600 req/min au paiement à l’usage, jusqu’à 60 req/s sur les forfaits supérieurs) ; temporisez et réessayez.
- 5xx — transitoire ; réessayez avec un backoff exponentiel.
Encadrez toujours les appels d’un retry avec backoff pour les 429/5xx.
7. Garder ça bon marché
- Les hits de cache sont à moitié prix — ne forcez pas de récupérations fraîches pour des requêtes répétées.
- Paginez de façon paresseuse.
- Choisissez
glprécisément pour éviter les ré-exécutions.
Étapes suivantes
-
Construisez quelque chose de concret : un suivi de positions en Python ou Google Search pour les agents IA.
-
Comparez les fournisseurs : l’API SERP la moins chère en 2026.
-
Créez un compte gratuit sur serp.cheap → (100 recherches offertes, sans carte)