Aller au contenu
FR
Obtenir une clé API

Google Search / Python

Récupérer les résultats Google avec Python et les exporter en CSV

Envoyez une requête à l’API Google Search, lisez les résultats organiques et exportez les titres, URL et extraits avec la bibliothèque standard de Python.

FlashData · Publié

Fiches de résultats de recherche organisées dans un tableur

Préparer l’environnement

Vous utiliserez Python 3 et sa bibliothèque standard. Créez une clé API et vérifiez que votre compte dispose de crédits. Pour une première requête, consultez le guide de démarrage avec l’API.

bash
# Replace YOUR_API_KEY near the top of the code below.

Le script ci-dessous recherche openai pour les États-Unis avec une interface en anglais, puis écrit les liens organiques renvoyés dans un fichier CSV.

Récupérer et enregistrer les résultats de recherche

Enregistrez le script dans search.py. Il soumet une requête en temps réel avec source: "google_search" et lit le tableau organic du premier résultat.

python
import csv
import json
import os
import urllib.request

base_url = "https://data.flashdata.dev"
api_key = "YOUR_API_KEY"
request = urllib.request.Request(
    base_url + "/v1/queries/realtime",
    data=json.dumps({
        "source": "google_search",
        "query": "openai",
        "params": {"gl": "us", "hl": "en", "num": 10},
    }).encode("utf-8"),
    headers={
        "X-API-Key": api_key,
        "Content-Type": "application/json",
    },
    method="POST",
)

with urllib.request.urlopen(request, timeout=60) as response:
    payload = json.load(response)

if payload.get("status") != "done":
    raise RuntimeError(payload.get("message", "Search did not complete"))

results = payload["results"][0].get("organic", [])
with open("google-results.csv", "w", newline="", encoding="utf-8") as output:
    writer = csv.DictWriter(output, fieldnames=["position", "title", "url", "snippet"])
    writer.writeheader()
    for result in results:
        writer.writerow({
            "position": result.get("position", ""),
            "title": result.get("title", ""),
            "url": result.get("link", ""),
            "snippet": result.get("snippet", ""),
        })

print(f"Saved {len(results)} results to google-results.csv")
bash
python3 search.py

Ouvrez google-results.csv dans un tableur ou chargez-le dans votre application. Les colonnes exportées sont position, title, URL et snippet. Le module CSV de Python gère les guillemets nécessaires pour les virgules et les retours à la ligne dans le texte.

Comprendre la réponse de l’API

Cet exemple de réponse montre la structure renvoyée pour une recherche OpenAI. Le script exporte les liens organiques ; les autres sections disponibles restent dans la réponse de l’API si votre application en a besoin.

json
{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "openai",
        "gl": "us",
        "hl": "en",
        "type": "search",
        "num": 10,
        "page": 1,
        "engine": "google"
      },
      "organic": [
        {
          "title": "OpenAI | Research & Deployment",
          "link": "https://openai.com/",
          "snippet": "We believe our research will eventually lead to artificial general intelligence, a system that can solve human-level problems.",
          "position": 1
        },
        {
          "title": "OpenAI",
          "link": "https://en.wikipedia.org/wiki/OpenAI",
          "snippet": "OpenAI is an American artificial intelligence (AI) public benefit corporation (PBC) headquartered in San Francisco. It develops proprietary generative AI models ...",
          "position": 2
        },
        {
          "title": "OpenAI",
          "link": "https://x.com/OpenAI",
          "snippet": "OpenAI's mission is to ensure that artificial general intelligence benefits all of humanity. can develop research, build financial models, and create ...",
          "position": 3
        },
        {
          "title": "OpenAI",
          "link": "https://www.linkedin.com/company/openai",
          "snippet": "OpenAI is an AI research and deployment company dedicated to ensuring that general-purpose artificial intelligence benefits all of humanity.",
          "position": 4
        },
        {
          "title": "r/OpenAI",
          "link": "https://www.reddit.com/r/OpenAI/",
          "snippet": "OpenAI is an AI research and deployment company. OpenAI's mission is to create safe and powerful AI that benefits all of humanity. OpenAI's ...",
          "position": 5
        }
      ],
      "peopleAlsoAsk": [
        {
          "question": "Is OpenAI created by Elon Musk?"
        },
        {
          "question": "Why are people leaving ChatGPT?"
        },
        {
          "question": "Is OpenAI the same as ChatGPT?"
        },
        {
          "question": "Why is OpenAI in trouble?"
        }
      ],
      "relatedSearches": [
        {
          "query": "OpenAI login"
        },
        {
          "query": "OpenAI chat"
        },
        {
          "query": "OpenAI ChatGPT"
        },
        {
          "query": "OpenAI - wikipedia"
        },
        {
          "query": "OpenAI API"
        },
        {
          "query": "OpenAI app"
        },
        {
          "query": "OpenAI download"
        },
        {
          "query": "OpenAI video"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:41:40.043Z"
}

Avec num, vous demandez un nombre de résultats. Google peut renvoyer moins de liens organiques que demandé. Le script enregistre tous les résultats reçus.

Modifier la recherche

Modifiez query pour votre sujet, params.gl pour le pays et params.hl pour la langue de l’interface. Utilisez params.page pour demander une autre page ; chaque page correspond à un appel API distinct.

Pour comparer les résultats dans le temps, enregistrez les mots recherchés, la région et la date de collecte avec chaque ligne. L’API renvoie un instantané de la recherche ; vos comparaisons historiques reposent sur les instantanés enregistrés.