Una consulta Google es sólo parte de una solicitud de búsqueda. Alguien que investiga Londres y alguien que investiga Singapur puede necesitar diferentes resultados para las mismas palabras. Esta guía muestra cómo solicitar un país, idioma de interfaz y ciudad, luego recopila un pequeño número de páginas de resultados sin contar duplicado URLs dos veces.
Usted construirá un script Python 3 que guarda tanto los resultados como los ajustes de búsqueda devueltos por el API. Si usted está haciendo su primera solicitud, comience con Resultados de la búsqueda de Google a CSV.
Qué control de gl, hl y ubicación
gles el código de dos letras, comogb,usosg.hlselecciona el idioma de interfaz Google, comoenode. No es una garantía de que cada página devuelta está escrita en ese idioma.locationsolicita un lugar de búsqueda. Utilice un nombre de ciudad claro, comoLondon, England, United Kingdom, cuando el contexto local importa.
Use estos parámetros juntos cuando desee una configuración de búsqueda explícita. Un lugar es una solicitud a la fuente de búsqueda, no una garantía de resultados idénticos al navegador de una persona en particular. Tipo de búsqueda, consulta, tiempo y datos disponibles pueden afectar la respuesta. results[0].searchParameters en lugar de asumir que el servicio aplicaba cada valor sin cambios.
Prepare su llave API y solicite presupuesto
Crear un Clave API y asegúrese de que la cuenta tiene disponibles Créditos. Almacene la clave en su entorno, no en el control de fuente o el navegador JavaScript. El código utiliza sólo la biblioteca estándar de Python.
export FLASHDATA_API_KEY='your-api-key'
export SEARCH_QUERY='coworking spaces'
export SEARCH_COUNTRY='gb'
export SEARCH_LANGUAGE='en'
export SEARCH_LOCATION='London, England, United Kingdom'
export SEARCH_MAX_PAGES='3'
num peticiones 1–100 resultados y page acepta 1-100. Los recuentos devueltos pueden ser más pequeños que los recuentos solicitados. Cada página es una solicitud de facturación independiente. Este ejemplo solicita hasta tres páginas, se detiene en una página vacía, y no retrata automáticamente las sumisiones fallidas.
Recopilar resultados localizados y preservar su contexto
Guarda esto como localized-search.py. Registra la página solicitada junto a cada resultado, mantiene el original position si uno es devuelto, y elimina sólo duplicado exacto URLs. No calcula deliberadamente una clasificación global de (page - 1) × num: el recuento devuelto puede variar.
import json
import os
from pathlib import Path
from urllib.error import HTTPError
from urllib.request import Request, urlopen
key = os.environ["FLASHDATA_API_KEY"]
max_pages = int(os.getenv("SEARCH_MAX_PAGES", "3"))
if not 1 <= max_pages <= 100:
raise ValueError("SEARCH_MAX_PAGES must be between 1 and 100")
query = os.getenv("SEARCH_QUERY", "coworking spaces")
settings = {
"gl": os.getenv("SEARCH_COUNTRY", "gb"),
"hl": os.getenv("SEARCH_LANGUAGE", "en"),
"location": os.getenv("SEARCH_LOCATION", "London, England, United Kingdom"),
"num": 10,
}
rows, pages, seen = [], [], set()
for page in range(1, max_pages + 1):
payload = {"source": "google_search", "query": query,
"params": {**settings, "page": page}}
request = Request(
"https://data.flashdata.dev/v1/queries/realtime",
data=json.dumps(payload).encode(), method="POST",
headers={"Content-Type": "application/json", "X-API-Key": key},
)
try:
with urlopen(request, timeout=60) as response:
body = json.load(response)
except HTTPError as error:
raise RuntimeError(f"Search failed: HTTP {error.code}. Check the request and account before resubmitting.") from error
if body.get("error") or body.get("status") != "done":
raise RuntimeError("Search did not complete. Check Request History before resubmitting.")
if not isinstance(body.get("results"), list) or not body["results"]:
raise RuntimeError("Expected a search result object")
result = body["results"][0]
organic = result.get("organic", [])
pages.append({"requestedPage": page, "requestedParams": payload["params"],
"reportedParams": result.get("searchParameters"),
"returnedCount": len(organic), "usage": body.get("usage")})
for item in organic:
link = item.get("link")
if link and link not in seen:
seen.add(link)
rows.append({"requestedPage": page, **item})
if not organic:
break
Path("localized-results.json").write_text(
json.dumps({"query": query, "pages": pages, "organic": rows}, indent=2),
encoding="utf-8",
)
print(f"Saved {len(rows)} unique URLs from {len(pages)} pages")
python3 localized-search.py
Lea la salida antes de comparar los mercados
El archivo JSON contiene un pages entrada para cada solicitud completada y organic array de enlaces únicos. Mantener requestedParams y reportedParams con sus datos. Un campo ausente debe permanecer ausente o nulo; no fabricar un país o valor de ubicación para una respuesta que no reportó uno.
Para comparar dos mercados, mantenga la consulta y el presupuesto de página solicitado coherente y cambie deliberadamente el país, el idioma y la ubicación. Recordar tiempo de recogida en su aplicación si necesita comparaciones históricas. Diferentes conjuntos de resultados son observaciones de esas solicitudes, no prueba de un cambio de rango permanente.
¿Por qué una página podría contener menos resultados?
Los resultados de la búsqueda pueden incluir características ricas, así como enlaces orgánicos, y la fuente puede devolver menos elementos orgánicos de lo solicitado. Cuenta el array devuelto. Una página orgánica vacía es una condición de parada razonable para este pequeño script; no establece que Google no tiene otras páginas relevantes.
Para errores 401/403, compruebe la tecla API y permisos. Para errores de crédito o límite de tarifas, resuelva primero el número de cuenta o tasa de solicitud. Un timeout de red no prueba que una solicitud de pago nunca fue ejecutada; inspeccionar Solicitar Historia antes de enviarlo de nuevo.
Continúe con Google Buscar referencia del parámetro API, guía de asinc y lotes, Google Buscar información general del producto.