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.
# 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.
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")
python3 search.pyAprire 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.
{
"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.