Zapytanie Google jest tylko częścią żądania wyszukiwania. Ktoś badający Londyn i ktoś badający Singapur może potrzebować różnych wyników dla tych samych słów. Ten przewodnik pokazuje, jak poprosić kraj, język interfejsu i miasto, a następnie zbierać niewielką liczbę stron wyników bez liczenia duplikatu URLs dwa razy.
Wybuduje się skrypt Python 3, który zapisuje zarówno wyniki jak i ustawienia wyszukiwania zwrócone przez API. Jeśli składasz pierwszą prośbę, zacznij od Wyniki wyszukiwania Google do CSV.
Co gl, hl i kontrola lokalizacji
gljest dwuliterowym kodem kraju, takim jakgb,uslubsg.hlwybiera język interfejsu Google, npenlubde. Nie jest to gwarancja, że każda zwrócona strona jest napisana w tym języku.locationżąda lokalizacji wyszukiwania. Użyj czystej nazwy miasta, takie jakLondon, England, United Kingdom, gdy kontekst lokalny ma znaczenie.
Użyj tych parametrów razem, gdy chcesz wyraźną konfigurację wyszukiwania. Lokalizacja to żądanie do źródła wyszukiwania, a nie gwarancja identycznych wyników do przeglądarki danej osoby. Typ wyszukiwania, zapytanie, czas i dostępne dane mogą mieć wpływ na odpowiedź. Kontrola results[0].searchParameters zamiast zakładać, że usługa zastosowała każdą wartość bez zmian.
Przygotuj swój klucz API i żądaj budżetu
Utwórz Klawisz API i upewnić się, że konto ma dostępne Kredyty. Klucz należy przechowywać w środowisku, nie w sterowniku źródła ani w przeglądarce JavaScript. Kod używa tylko standardowej biblioteki 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 wnioski 1–100 wyniki i page akceptuje 1–100. Zwrócone liczby mogą być mniejsze niż wymagane. Każda strona jest osobnym billable żądanie. Ten przykład wymaga do trzech stron, zatrzymuje się na pustej stronie i nie automatycznie ponownie próbuje nieudanych zgłoszeń.
Zbierz wyniki lokalizowane i zachować ich kontekst
Zapisz to jako localized-search.py. Zapisuje żądaną stronę obok każdego wyniku, zachowuje oryginał position jeśli jeden jest zwracany i usuwa tylko dokładny duplikat URLs. Celowo nie oblicza globalnego rankingu z (page - 1) × num: liczba zwrócona może się zmieniać.
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
Odczyt produkcji przed porównaniem rynków
Plik JSON zawiera pages wpis dotyczący każdego wypełnionego wniosku oraz organic tablica unikalnych linków. Zachowaj requestedParams oraz reportedParams z danymi. Nieobecne pole powinno pozostać nieobecne lub null; nie wytwarzać wartości kraju lub lokalizacji dla odpowiedzi, która nie zgłosiła takiego pola.
Aby porównać dwa rynki, zachować zapytanie i żądany budżet strony spójne i zmienić kraj, język i lokalizację celowo. Czas zbierania rekordów w aplikacji, jeśli potrzebujesz porównań historycznych. Różne zestawy wyników to obserwacje z tych wniosków, a nie dowód stałej zmiany rangi.
Dlaczego strona może zawierać mniej wyników?
Wyniki wyszukiwania mogą obejmować bogate funkcje, jak również ogniwa organiczne, a źródło może zwrócić mniej elementów organicznych niż wymagane. Policz zwróconą tablicę. Pusta strona organiczna jest rozsądnym warunkiem zatrzymania tego małego skryptu; nie stwierdza, że Google nie ma innych odpowiednich stron.
W przypadku błędów 401/403 należy sprawdzić klucz i uprawnienia API. W przypadku błędów kredytowych lub rate- limit, najpierw rozwiąż kwestię konta lub request- rate. Timeout sieci nie udowadnia, że wniosek płatny nigdy nie został zrealizowany; sprawdź wniosek History przed złożeniem go ponownie.
Kontynuuj Google Search API parametr odniesienia, async i przewodnik po serii, lub Przegląd produktu Google Search.