Przejdź do treści
PL
Uzyskaj klucz API

Google Search / Python

Pobierz wyniki wyszukiwania Google za pomocą Python i zapisz je na CSV

Wyślij Google Search API, przeczytaj wyniki ekologiczne i tytuły eksportowe, URLs i snippety ze standardową biblioteką Python.

FlashData · Opublikowane

Wyszukaj karty wyników zorganizowane w arkuszu kalkulacyjnym

Przygotuj swoje środowisko

Użyjesz Python 3 i jego standardowej biblioteki. Utwórz Klawisz API i upewnij się, że Twoje konto ma dostępne kredyty. Jeśli jest to twoja pierwsza prośba, zobacz Szybki start API.

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

Poniższy skrypt wyszukuje openai za pomocą wyników USA i interfejsu angielskiego, a następnie zapisuje zwrócone linki organiczne do pliku CSV.

Pobierz i zapisz wyniki wyszukiwania

Zapisz skrypt jako search.py. Zwraca on jedną prośbę w czasie rzeczywistym z source: "google_search" i czyta organic tablica z pierwszego wyniku.

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

Otwórz google-results.csv w arkuszu kalkulacyjnym lub załadować go do aplikacji. Eksportowane kolumny to pozycja, tytuł, URL i snippet. Pythonjest CSV pisarz obsługuje cytowanie przecinków i przerw w linii wewnątrz tekstu wyniku.

Zrozum odpowiedź API

Ta zarejestrowana odpowiedź pokazuje, że struktura została zwrócona do wyszukiwania OpenAI. Skrypt eksportuje ogniwa organiczne; inne dostępne sekcje pozostają w odpowiedzi API, jeśli Twoja aplikacja ich potrzebuje.

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

W num parametr wymaga liczenia wyników. Nie gwarantuje to, że Google powróci z tak wieloma ogniwami organicznymi. Skrypt zapisuje, niezależnie od tego, ile wyników zostanie zwróconych.

Zmień wyszukiwanie

Zmiana query dla twojego tematu, params.gl dla kraju oraz params.hl dla języka interfejsu. Stosowanie params.page do żądania innej strony; każda strona jest oddzielnym wywołaniem API.

Aby porównać wyniki w czasie, należy przechowywać zapytanie, region i czas zbierania obok każdego wiersza. API zwraca migawkę wyszukiwania; porównania historyczne pochodzą z migawek, które zapisujesz.