Überspringen zum Inhalt
DE
API-Schlüssel

Google Search / Python

Erhalten Sie Google Suchergebnisse mit Python und speichern Sie sie in CSV

Senden Sie eine Google Search API-Anfrage, lesen Sie organische Ergebnisse und Exporttitel, URLs und Snippets mit der Standardbibliothek von Python.

FlashData · Veröffentlicht

Suchergebniskarten, die in einer Tabelle organisiert sind

Bereiten Sie Ihre Umgebung vor

Sie verwenden Python 3 und seine Standardbibliothek. Erstellen Sie eine API Schlüssel Stellen Sie sicher, dass Ihr Konto über verfügbare Credits verfügt. Wenn dies Ihre erste Anfrage ist, sehen Sie die API Quickstart.

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

Das Skript unten sucht nach openai Verwenden von US-Ergebnissen und einer englischen Schnittstelle, dann schreibt die zurückgegebenen organischen Links zu einer CSV-Datei.

Holen und speichern Sie die Suchergebnisse

Speichern Sie das Skript als search.py. Es sendet eine Echtzeit-Anfrage mit source: "google_search" und liest die organic Array aus dem ersten Ergebnis.

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

Offen google-results.csv in einer Tabelle oder laden Sie es in Ihre Anwendung. Die exportierten Spalten sind Position, Titel, URL und Snippet. Der CSV-Schriftsteller von Python verarbeitet das Zitieren für Kommas und Zeilenumbrüche im Ergebnistext.

Verstehen Sie die API Antwort

Diese aufgezeichnete Antwort zeigt die Struktur, die für eine OpenAI-Suche zurückgegeben wurde. Das Skript exportiert organische Links; andere verfügbare Abschnitte verbleiben in der API-Antwort, wenn Ihre Anwendung sie benötigt.

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"
}

Die num Parameter fordert eine Ergebniszählung an. Es garantiert nicht, dass Google so viele organische Links zurückgibt. Das Skript speichert, wie viele Ergebnisse zurückgegeben werden.

Ändern Sie die Suche

Änderung query für dein Thema, params.gl für das Land und params.hl für die Schnittstellensprache. Verwendung params.page eine andere Seite anzufordern; jede Seite ist ein separater API-Aufruf.

Um die Ergebnisse über die Zeit zu vergleichen, speichern Sie die Abfrage, Region und Sammlungszeit neben jeder Zeile. Der API gibt einen Such-Snapshot zurück; historische Vergleiche stammen aus den Schnappschüssen, die Sie speichern.