Locations ve diller: gl, hl, location, google_domain ve device

gl, hl ve location arasındaki fark nedir?

gl hangi ülkenin sonuçlarını istediğinizi söyler. hl kişinin hangi dili okuduğunu söyler; bu arayüzü ve çoğu zaman soruları ve snippet'leri değiştirir. location ülkeyi bir şehre veya bölgeye daraltır; bu, bir sorguda yerel niyet olduğu anda önem kazanır.

Serbestçe birleşirler. İsviçre'deki Fransızca konuşan biri gl=ch, hl=fr olur. Berlin'den yapılan İngilizce bir arama gl=de, hl=en, location=Berlin, Berlin, Germany olur. gl ile location ülkesini aynı tutun: bir ülkedeki şehir ile başka bir ülkenin gl değeri, hiçbir gerçek ziyaretçinin görmediği sonuçlar verir.

Bir şehri nasıl hedeflerim?

Yeri İngilizce olarak, en küçük birimden en büyüğe doğru yazın: City, Region, Country. Örnekler: Austin, Texas, United States, Manchester, England, United Kingdom, Munich, Bavaria, Germany, Lyon, Auvergne-Rhone-Alpes, France. Sokak veya posta kodu değil, şehrin adını kullanın.

Yanıttaki search_parameters.location değerini kontrol edin: uygulanan yeri gösterir. Kullanılamayan bir değer 400 invalid_parameter döndürür ve hiçbir şeye mal olmaz, böylece bir yer listesini ucuza test edebilirsiniz.

# The same query from two cities: compare the local packs
for city in "Austin, Texas, United States" "Denver, Colorado, United States"; do
  curl -sG "https://serpcrypto.com/api/v1/search" \
    -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
    --data-urlencode "q=emergency plumber" \
    --data-urlencode "location=$city" \
    -d gl=us -d hl=en -d device=mobile \
    | jq -r --arg city "$city" '.local_results[]? | "\($city)\t\(.position)\t\(.title)"'
done

Hangi Google alan adını kullanmalıyım?

Genellikle hiçbiri: google_domain alanını boş bırakın, API yukarıdaki tabloda olduğu gibi gl ülkesinin alan adını kullanır. Yalnızca belirli bir kurulumu yeniden oluşturmak için ayarlayın, örneğin google.com ile gl=gb.

Alan adı tek başına sonuçların ülkesini tanımlamaz. İşin çoğunu gl ve location yapar, bu yüzden yanıt üçünü de search_parameters içinde kaydeder.

Mobil ve masaüstü sonuçları farklı mı?

Çoğu zaman evet. Mobil sayfa blokları farklı sıralayabilir, yakındaki aramalara daha fazla yerel sonuç gösterebilir ve snippet'leri daha kısa kesebilir. Ziyaretçileriniz çoğunlukla telefon kullanıyorsa device=mobile alanını takip edin; tam bir görünüm için ikisini de takip edin ve her sıralamayla birlikte cihazı saklayın.

Her cihaz ayrı bir aramadır, bu yüzden ikisini de takip etmek bu anahtar kelimeler için kredileri ikiye katlar. 100.000 arama paketinde $0,56/1K arama ile 30 gün boyunca iki cihazda 1.000 anahtar kelime 60.000 arama kullanır.

Tek bir script'te birkaç ülkeyi nasıl karşılaştırırım?

Pazarların listesi üzerinde döngü kurun ve API'nin uyguladıklarını saklayın. Python örneği, her biri bir şehirle üç ülkeye tek bir sorgu gönderir ve kullanılan alan adını ve ilk bağlantıyı yazdırır.

import os

import requests

MARKETS = [
    {"gl": "de", "hl": "de", "location": "Munich, Bavaria, Germany"},
    {"gl": "fr", "hl": "fr", "location": "Lyon, Auvergne-Rhone-Alpes, France"},
    {"gl": "br", "hl": "pt-BR", "location": "Curitiba, State of Parana, Brazil"},
]

for market in MARKETS:
    r = requests.get(
        "https://serpcrypto.com/api/v1/search",
        params={"q": "running shoes", **market},
        headers={"Authorization": "Bearer " + os.environ["SERPCRYPTO_API_KEY"]},
        timeout=60,
    )
    r.raise_for_status()
    applied = r.json()["search_parameters"]
    top = r.json().get("organic_results", [])[:1]
    print(applied["gl"], applied.get("google_domain"), [x["link"] for x in top])

Bing aynı parameter'leri alıyor mu?

q, gl, hl, device ve page için evet: aynı kodları engine=bing ile kullanın. google_domain Bing için geçerli değildir ve yok sayılır. Yanıt aynı çerçeveye sahiptir, organic_results ve related_searches ile; kullanım senaryoları için Bing sayfasına bakın.