Salta al contenuto
IT
Ottieni la chiave API

Google Search / Python

Ottieni i risultati di ricerca Google con Python e salvali in CSV

Invia una richiesta Google Cerca API, legge i risultati organici e i titoli di esportazione, URLs e snippets con la libreria standard di Python.

FlashData · Pubblicato

Carte di risultato di ricerca organizzate in un foglio di calcolo

Preparare l'ambiente

Userai Python 3 e la sua libreria standard. Creare un Chiave API e assicurarsi che il tuo account abbia crediti disponibili. Se questa è la vostra prima richiesta, vedere il Avvio rapido API.

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

Lo script qui sotto cerca openai utilizzando i risultati degli Stati Uniti e un'interfaccia inglese, poi scrive i link organici restituiti a un file CSV.

Risparmiare e salvare i risultati di ricerca

Salvare lo script come search.py. Presenta una richiesta in tempo reale con source: "google_search" e legge il organic array dal primo risultato.

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

Aprire google-results.csv in un foglio di calcolo o caricarlo nella vostra applicazione. Le colonne esportate sono posizione, titolo, URL e snippet. PythonLa sua CSV scrittore gestisce citando per virgole e interruzioni di linea all'interno del testo del risultato.

Comprendere la risposta API

Questa risposta registrata mostra la struttura restituita per una ricerca OpenAI. Lo script esporta collegamenti organici; altre sezioni disponibili rimangono nella risposta API se la vostra applicazione ha bisogno di loro.

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

Il num le richieste dei parametri di un conteggio dei risultati. Non garantisce che Google restituirà che molti collegamenti organici. Lo script salva tuttavia molti risultati vengono restituiti.

Cambiare la ricerca

Variazione query per il tuo argomento, params.gl per il paese e params.hl per la lingua dell'interfaccia. Uso params.page per richiedere un'altra pagina; ogni pagina è una chiamata API separata.

Per confrontare i risultati nel tempo, memorizzare la query, la regione e il tempo di raccolta accanto a ogni riga. Lo API restituisce un'istantanea di ricerca; i confronti storici provengono dalle istantanee salvate.