Prepare su entorno
Usted utilizará Python 3 y su biblioteca estándar. Clave API y asegúrese de que su cuenta tiene créditos disponibles. Si esta es su primera solicitud, vea la API de arranque rápido.
# Replace YOUR_API_KEY near the top of the code below.El script a continuación busca openai usando los resultados de EE.UU. y una interfaz de Inglés, luego escribe los enlaces orgánicos devueltos a un archivo CSV.
Busque y guarde los resultados de la búsqueda
Guardar el script como search.pyPresenta una solicitud en tiempo real source: "google_search" y lee el organic array del primer resultado.
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.pyAbierto google-results.csv en una hoja de cálculo o cargarla en su aplicación. Las columnas exportadas son posición, título, URL y el snippet. Python’s CSV escritor maneja citando comas y rupturas de línea dentro del texto resultado.
Comprender la respuesta API
Esta respuesta registrada muestra la estructura devuelta para una búsqueda de OpenAI. El script exporta enlaces orgánicos; otras secciones disponibles permanecen en la respuesta API si su aplicación los necesita.
{
"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"
}El num El parámetro solicita un recuento de resultados. No garantiza que Google devuelva que muchos enlaces orgánicos. El script ahorra sin embargo muchos resultados son devueltos.
Cambiar la búsqueda
Cambio query para su tema, params.gl para el país y params.hl para el lenguaje de interfaz. Uso params.page para solicitar otra página; cada página es una llamada API separada.
Para comparar los resultados con el tiempo, almacene la consulta, región y tiempo de recogida junto a cada fila. El API devuelve una instantánea de búsqueda; las comparaciones históricas provienen de las instantáneas que guarda.