İçeriğe geç
TR
API anahtarı al

Google Search / Python

Google Search API: Ülke, dil ve dil Python

Yerelleştirilmiş Google sonuçları talep etmek için gl, hl ve yer kullanın, güvenli bir şekilde piginate ve Python ile geri arama ayarlarını kurtarın.

FlashData · Yayınlanmış Yayınlanmış Yayınlandı

Yerelleştirilmiş arama sonuçları, birkaç sonuç sayfa ile bir dünya çapında

Bir Google sorgu sadece bir arama isteğinin bir parçasıdır. Londra'yı araştıran biri ve Singapur'u araştıran biri aynı kelimeler için farklı sonuçlara ihtiyaç duyabilir. Bu kılavuz, bir ülke, arayüz dili ve şehri nasıl talep edeceğini gösterir, sonra tekrar URLs saymadan küçük bir sonuç sayfası toplar.

Bir inşa edeceksin Python 3 Bu senaryo hem sonuçları hem de arama ayarları geri döndü API. İlk isteğinizi yaparsanız, başlayın Google arama sonuçları CSV.

gl, hl ve konum kontrolü

  • gl İki renkli ülke kodu, örneğin gb, us veya veya veya sg.

  • hl Google arayüzü dilini seçin, örneğin en veya veya veya de. Bu dilde her iade sayfasının yazıldığı bir garanti değildir.

  • location Bir arama yeri talep eder. Açık bir şehir adını kullanın, örneğin London, England, United Kingdom, Yerel bağlam önemli olduğunda.

Bu parametreleri açık bir arama konfigürasyonu istediğinizde birlikte kullanın. Bir konum arama kaynağı için bir istektir, belirli bir kişinin tarayıcısına aynı sonuçları garanti etmez. Arama türü, sorgu, zamanlama ve mevcut veriler cevabı etkileyebilir. Inspect results[0].searchParameters Hizmetin her değerin değişmediğini varsaymak yerine.

API anahtarınızı hazırlayın ve bütçe talep

Oluşturun API anahtarı ve hesabın mevcut kredilere olduğundan emin olun. Çevrenizdeki anahtarı depolayın, kaynak kontrolü veya tarayıcı JavaScript. Kod sadece Python'un standart kütüphanesini kullanır.

bash
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 1–100 sonuçları ve page 1–100'u kabul edin. Geri dönen sayılar talep edilen sayıdan daha küçük olabilir. Her sayfa ayrı bir faturalı istektir. Bu örnek üç sayfaya kadar talep eder, boş bir sayfada durur ve otomatik olarak geri gönderilmez.

Yerelleştirilmiş sonuçları toplayın ve bağlamlarını korur

Bunu kurtarmak olarak localized-search.py. Her bir sonucun yanında istenen sayfayı kaydeder, orijinali tutar position Eğer biri geri döndüyse ve sadece URLs'u tam olarak geri kaldırır. Bu kasıtlı olarak küresel bir sıralama hesaplamaz (page - 1) × num: Geri sayı değişebilir.

python
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")
bash
python3 localized-search.py

Pazarları karşılaştırmadan önce çıktıyı okuyun

JSON dosyası bir tane içeriyor pages Her tamamlanma isteği ve bir istek için giriş ve organic eşsiz bağlantıların dizisi. Keep Keep Keep requestedParams Ve ve reportedParams verilerinizle. Yok bir alan yok veya null kalmalı; Bir ülkeyi veya bir tane rapor etmeyen bir yanıt için bir değer üretmemelidir.

İki piyasayı karşılaştırmak için, sorguyu tut ve sayfa bütçesini tutarlı bir şekilde değiştirin ve ülkeyi, dili ve yeri kasıtlı olarak değiştirin. Uygulamanızda tarih karşılaştırmalarına ihtiyacınız varsa kayıt toplama zamanı. Farklı sonuç setleri bu isteklerden gözlemler, kalıcı bir sıralama değişikliği kanıtı değildir.

Bir sayfa neden daha az sonuç içeriyor olabilir?

Arama sonuçları, organik bağlantıların yanı sıra zengin özellikleri de içerebilir ve kaynak talep edilenden daha az organik eşya geri dönebilir. Geri döndü diziyi sayın. Boş bir organik sayfa bu küçük senaryo için makul bir durdurma koşuludur; Google'nun başka bir ilgili sayfaları yoktur.

401/403 hataları için, API anahtar ve izinleri kontrol edin. Kredi veya oran-limit hataları için, ilk önce hesabı veya istek-söz konusu çöz. Bir ağ süresi, ücretli bir talebin asla idam edilmediğini kanıtlamıyor; tekrar göndermeden önce History'u inceleme.

Devam et birlikte devam et Google Search API parametre referans, Async ve toplu kılavuz, veya Google Search ürün genel bakış.