Una query Google fa solo parte di una richiesta di ricerca. Qualcuno che ricerca Londra e qualcuno che cerca Singapore potrebbe aver bisogno di risultati diversi per le stesse parole. Questa guida mostra come richiedere un paese, un linguaggio di interfaccia e una città, quindi raccogliere un piccolo numero di pagine dei risultati senza contare due volte duplicati URLs.
Costruirete uno script Python 3 che salva i risultati e le impostazioni di ricerca restituite dallo API. Se stai facendo la tua prima richiesta, inizia con Risultati di ricerca Google a CSV.
Che gl, hl e controllo posizione
glè il codice paese a due lettere, comegb,usosg.hlseleziona la lingua di interfaccia Google, comeenode. Non è una garanzia che ogni pagina restituita sia scritta in quella lingua.locationrichiede una posizione di ricerca. Utilizzare un nome di città chiaro, comeLondon, England, United Kingdom, quando il contesto locale conta.
Utilizzare questi parametri insieme quando si desidera una configurazione di ricerca esplicita. Una posizione è una richiesta alla fonte di ricerca, non una garanzia di risultati identici al browser di una persona particolare. Tipo di ricerca, query, tempistica e dati disponibili possono influenzare la risposta. Ispezione results[0].searchParameters invece di assumere il servizio applicato ogni valore invariato.
Prepara il tuo tasto API e richiedi il budget
Creare un Chiave API e assicurarsi che l'account abbia a disposizione Crediti. Conservare la chiave nel vostro ambiente, non nel controllo sorgente o nel browser JavaScript. Il codice utilizza solo la libreria standard di 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 richieste 1–100 risultati e page accetta 1–100. I conti resi possono essere più piccoli del conteggio richiesto. Ogni pagina è una richiesta di fatturazione separata. Questo esempio richiede fino a tre pagine, si ferma su una pagina vuota, e non riprova automaticamente le presentazioni fallite.
Raccogliere risultati localizzati e preservare il loro contesto
Salvare questo come localized-search.py. Registra la pagina richiesta accanto ad ogni risultato, mantiene l'originale position se uno viene restituito, e rimuove solo il duplicato esatto URLs. Non calcola volutamente una classifica globale da (page - 1) × num: il conteggio restituito può variare.
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
Leggi l'output prima di confrontare i mercati
Il file JSON contiene un pages ingresso per ogni richiesta completata e un organic array di link unici. Continua requestedParams e reportedParams con i tuoi dati. Un campo assente dovrebbe rimanere assente o null; non produrre un paese o un valore di posizione per una risposta che non ha segnalato uno.
Per confrontare due mercati, mantenere la query e il budget della pagina richiesta coerente e cambiare il paese, la lingua e la posizione deliberatamente. Registra il tempo di raccolta nella tua applicazione se hai bisogno di confronti storici. Diversi set di risultati sono osservazioni da quelle richieste, non prova di un cambiamento permanente del rango.
Perché una pagina potrebbe contenere meno risultati?
I risultati della ricerca possono includere caratteristiche ricche e link organici, e la fonte può restituire meno elementi organici di quanto richiesto. Conta la matrice restituita. Una pagina organica vuota è una condizione di arresto ragionevole per questo piccolo script; non stabilisce che Google non ha altre pagine rilevanti.
Per gli errori 401/403, controlla il tasto API e le autorizzazioni. Per errori di credito o di tasso-limite, risolvere prima il problema del conto o del tasso di richiesta. Un timeout di rete non dimostra che una richiesta a pagamento non sia mai stata eseguita; ispezionare la richiesta History prima di inviarla di nuovo.
Continuare con il Riferimento del parametro Google Search API, guida asincrona e batch, o Google Cerca la panoramica dei prodotti.