API Google Search en Python : tutoriel complet (2026)

Ce tutoriel montre comment interroger Google depuis Python et obtenir des résultats propres et structurés — en utilisant serp.cheap, l’API Google Search la moins chère en 2026.

Installation

pip install requests

Exemple minimal

import requests

resp = requests.post(
    "https://api.serp.cheap/v1/search",
    headers={"X-API-Key": "YOUR_KEY"},
    json={"q": "best electric cars 2026", "gl": "us", "page": 1},
    timeout=30,
)
resp.raise_for_status()
for r in resp.json()["organic"]:
    print(f'#{r["position"]} {r["title"]} — {r["link"]}')

Un client réutilisable avec retries

import requests
from requests.adapters import HTTPAdapter, Retry

class SerpClient:
    def __init__(self, api_key: str):
        self.s = requests.Session()
        self.s.headers.update({"X-API-Key": api_key})
        retries = Retry(total=4, backoff_factor=1.5,
                        status_forcelist=[429, 500, 502, 503, 504])
        self.s.mount("https://", HTTPAdapter(max_retries=retries))

    def search(self, q, gl="us", page=1, tbs=None):
        body = {"q": q, "gl": gl, "page": page}
        if tbs:
            body["tbs"] = tbs
        r = self.s.post("https://api.serp.cheap/v1/search", json=body, timeout=30)
        r.raise_for_status()
        return r.json()

client = SerpClient("YOUR_KEY")
data = client.search("python web scraping", gl="us")
print(data["stats"])  # balance, cost, cached

Pagination

def all_results(client, q, pages=3, gl="us"):
    out = []
    for p in range(1, pages + 1):
        out += client.search(q, gl=gl, page=p)["organic"]
    return out

Chaque page est une requête facturée séparément — récupérez-les de façon paresseuse. Plus de détails dans pagination.

Contrôle des coûts

stats.cost est exprimé en crédits (1 = 0,0001 $). Les hits de cache coûtent 3 crédits, une récupération fraîche 6. Les requêtes répétées sont servies automatiquement depuis le cache à moitié prix.

Pour aller plus loin

• Construire un suivi de positions en Python

• API Google Search pour les agents IA

• Autres langages : Node.js · Go · PHP

• Obtenir une clé API →