← Retour au blog

Comment utiliser une API Google Search en 2026 : guide complet

Apprenez à utiliser une API Google Search de bout en bout — auth, paramètres, parsing, pagination et contrôle des coûts — avec du code Python, Node.js et curl.

2 min de lecture

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ètreDéfautDescription
qrequisLa requête de recherche
gl"us"Pays (par exemple br, gb, de)
hldéfaut du paysSurcharge de la langue de l’interface
page1Page de résultats (indexée à partir de 1)
tbsaucunFiltre 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é

  1. Les hits de cache sont à moitié prix — ne forcez pas de récupérations fraîches pour des requêtes répétées.
  2. Paginez de façon paresseuse.
  3. Choisissez gl précisément pour éviter les ré-exécutions.

Étapes suivantes

Questions fréquentes

Comment appeler une API Google Search ?+

Envoyez une requête POST authentifiée avec votre requête. Avec serp.cheap : POST https://api.serp.cheap/v1/search, en-tête X-API-Key, corps JSON comme {"q": "...", "gl": "us"}. La réponse est du JSON avec un tableau organic[] de résultats.

Puis-je appeler une API Google Search depuis le navigateur ?+

Non — n'exposez jamais votre clé API dans du code côté client. Faites toujours transiter les requêtes par votre propre backend pour que la clé reste secrète.

Comment maintenir des coûts bas avec une API Google Search ?+

Appuyez-vous sur le cache (les requêtes répétées sont servies à moitié prix sur serp.cheap), ne récupérez des pages supplémentaires que lorsque c'est nécessaire, et suivez stats.cost à chaque appel.

Obtenez votre clé API

Le moins cher en direct, payez par carte ou crypto, sans KYC. Ou via une marketplace.