Uma consulta Google é apenas parte de um pedido de busca. Alguém pesquisando Londres e alguém pesquisando Singapura pode precisar de resultados diferentes para as mesmas palavras. Este guia mostra como solicitar um país, linguagem de interface e cidade, em seguida, recolher um pequeno número de páginas de resultados sem contar duplicado URLs duas vezes.
Você construirá um script Python 3 que salva os resultados e as configurações de busca retornadas pelo API. Se você está fazendo seu primeiro pedido, comece com Google resultados de busca para CSV.
Que gl, hl e controle de localização
glé o código de duas letras do país, comogb,usousg.hlseleciona a linguagem de interface Google, comoenoude. Não é uma garantia de que cada página devolvida está escrita nessa língua.locationsolicita um local de busca. Use um nome claro da cidade, comoLondon, England, United Kingdom, quando o contexto local importa.
Use estes parâmetros juntos quando quiser uma configuração explícita de busca. Um local é um pedido à fonte de busca, não uma garantia de resultados idênticos ao navegador de uma pessoa em particular. Tipo de pesquisa, consulta, timing e dados disponíveis podem afetar a resposta. Inspecione. results[0].searchParameters em vez de assumir que o serviço aplicava cada valor inalterado.
Prepare sua chave API e peça orçamento
Criar um API chave E certifique-se de que a conta tenha créditos disponíveis. Guarde a chave em seu ambiente, não no controle de origem ou no navegador JavaScript. O código usa apenas a biblioteca padrão do 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 Solicita resultados 1–100 e page aceita 1–100. Contagens devolvidas podem ser menores do que as solicitadas. Cada página é um pedido de cobrança separado. Este exemplo requer até três páginas, pára em uma página vazia, e não tenta automaticamente refazer as submissões falhadas.
Recolha resultados localizados e mantenha seu contexto
Guarde isso como localized-search.py. Ele registra a página solicitada ao lado de cada resultado, mantém o original position Se um é devolvido, e remove apenas o exato duplicado URLs. Ele deliberadamente não calcula um ranking global a partir de (page - 1) × num: A contagem retornada pode 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
Leia a saída antes de comparar os mercados
O arquivo JSON contém um pages entrada para cada pedido completado e um organic Uma série de links únicos. Continue requestedParams e.. reportedParams Com seus dados. Um campo ausente deve permanecer ausente ou null; não fabrique um país ou valor de localização para uma resposta que não tenha relatado um.
Para comparar dois mercados, mantenha a consulta e o orçamento solicitado consistente e mude o país, idioma e localização deliberadamente. Grave o tempo de coleta em sua aplicação se precisar de comparações históricas. Diferentes conjuntos de resultados são observações desses pedidos, não prova de uma mudança permanente de posto.
Por que uma página pode conter menos resultados?
Os resultados da pesquisa podem incluir recursos ricos, bem como links orgânicos, e a fonte pode devolver menos itens orgânicos do que solicitado. Conte a matriz de volta. Uma página orgânica vazia é uma condição razoável para parar este pequeno script, não estabelece que Google não tem outras páginas relevantes.
Para erros 401/403, verifique a chave API e permissões. Para erros de crédito ou taxa limite, resolver a conta ou pedido de taxa primeiro. Um tempo limite de rede não prova que um pedido pago nunca foi executado, inspecione o pedido History antes de enviá-lo novamente.
Continue com o Google Pesquisa referência de parâmetros API, Sincronia e guia de lote, ou Google Pesquisa visão geral do produto.