Lokalizacje i języki: gl, hl, location, google_domain i device

Jaka jest różnica między gl, hl i location?

gl mówi, z jakiego kraju chcesz wyniki. hl mówi, w jakim języku czyta osoba, co zmienia interfejs, a często też pytania i snippety. location zawęża kraj do miasta lub regionu, co ma znaczenie, gdy zapytanie ma intencję lokalną.

Łączą się swobodnie. Francuz w Szwajcarii to gl=ch, hl=fr. Wyszukiwanie po angielsku z Berlina to gl=de, hl=en, location=Berlin, Berlin, Germany. Trzymaj gl i kraj w location zgodne: miasto w jednym kraju z gl innego daje wyniki, których nie widzi żaden realny użytkownik.

Jak wycelować w miasto?

Zapisz miejsce po angielsku, od najmniejszej jednostki do największej: City, Region, Country. Przykłady: Austin, Texas, United States, Manchester, England, United Kingdom, Munich, Bavaria, Germany, Lyon, Auvergne-Rhone-Alpes, France. Użyj nazwy miasta, nie ulicy ani kodu pocztowego.

Sprawdź search_parameters.location w odpowiedzi: pokazuje zastosowane miejsce. Wartość, której nie da się użyć, zwraca 400 invalid_parameter i nic nie kosztuje, więc możesz tanio przetestować listę miejsc.

# 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

Której domeny Google powinienem użyć?

Zwykle żadnej: pomiń google_domain, a API użyje domeny kraju gl, jak w tabeli powyżej. Ustaw ją tylko po to, by odtworzyć konkretną konfigurację, na przykład google.com z gl=gb.

Sama domena nie określa kraju wyników. Większość pracy wykonują gl i location, dlatego odpowiedź zapisuje wszystkie trzy w search_parameters.

Czy wyniki mobilne i desktopowe się różnią?

Często tak. Strona mobilna może inaczej układać bloki, pokazywać więcej wyników lokalnych dla zapytań o pobliskie miejsca i skracać snippety. Jeśli Twoi odwiedzający najczęściej korzystają z telefonów, śledź device=mobile; dla pełnego obrazu śledź oba i zapisuj urządzenie przy każdym rankingu.

Każde urządzenie to osobne wyszukiwanie, więc śledzenie obu podwaja kredyty dla tych słów kluczowych. Przy 0,56 USD/1K wyszukiwań w pakiecie 100 000 wyszukiwań, 1 000 słów kluczowych na dwóch urządzeniach przez 30 dni zużywa 60 000 wyszukiwań.

Jak porównać kilka krajów w jednym skrypcie?

Przejdź w pętli po liście rynków i zapisuj to, co zastosowało API. Przykład w Pythonie wysyła jedno zapytanie do trzech krajów, każde z miastem, i wypisuje użytą domenę oraz pierwszy link.

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])

Czy Bing przyjmuje te same parametry?

Tak dla q, gl, hl, device i page: użyj tych samych kodów z engine=bing. google_domain nie dotyczy Binga i jest ignorowany. Odpowiedź ma tę samą strukturę, z organic_results i related_searches; zobacz stronę Bing, aby poznać jej przypadki użycia.