Locaties en talen: gl, hl, location, google_domain en device

Wat is het verschil tussen gl, hl en location?

gl bepaalt van welk land je resultaten wilt. hl bepaalt welke taal de persoon leest, wat de interface verandert en vaak ook de vragen en snippets. location vernauwt het land tot een stad of regio, wat telt zodra een zoekopdracht een lokale intentie heeft.

Ze combineren vrij. Een Franstalige in Zwitserland is gl=ch, hl=fr. Een zoekopdracht in het Engels vanuit Berlijn is gl=de, hl=en, location=Berlin, Berlin, Germany. Houd gl en het land van location gelijk: een stad in het ene land met gl van een ander land geeft resultaten die geen enkele echte bezoeker ziet.

Hoe richt ik me op een stad?

Schrijf de plaats in het Engels, van de kleinste eenheid naar de grootste: City, Region, Country. Voorbeelden: Austin, Texas, United States, Manchester, England, United Kingdom, Munich, Bavaria, Germany, Lyon, Auvergne-Rhone-Alpes, France. Gebruik de naam van de stad, geen straat of postcode.

Controleer search_parameters.location in het antwoord: dat toont de toegepaste plaats. Een waarde die niet kan worden gebruikt, geeft 400 invalid_parameter terug en kost niets, dus je kunt een lijst met plaatsen goedkoop testen.

# 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

Welk Google-domein moet ik gebruiken?

Meestal geen: laat google_domain weg en de API gebruikt het domein van het land van gl, zoals in de tabel hierboven. Stel het alleen in om een specifieke setup te reproduceren, bijvoorbeeld google.com met gl=gb.

Het domein alleen bepaalt niet het land van de resultaten. gl en location doen het meeste werk, daarom legt het antwoord alle drie vast in search_parameters.

Verschillen mobiele en desktopresultaten?

Vaak wel. De mobiele pagina kan blokken anders ordenen, meer lokale resultaten tonen voor zoekintenties in de buurt en snippets korter maken. Als je bezoekers vooral hun telefoon gebruiken, volg dan device=mobile; voor een volledig beeld volg je beide en sla je het device op bij elke ranking.

Elk device is een aparte zoekopdracht, dus beide volgen verdubbelt de credits voor die keywords. Bij US$ 0,56/1K zoekopdrachten op het 100.000 zoekopdrachten pack gebruiken 1.000 keywords op twee devices gedurende 30 dagen 60.000 zoekopdrachten.

Hoe vergelijk ik meerdere landen in één script?

Loop over een lijst met markten en bewaar wat de API heeft toegepast. Het Python-voorbeeld stuurt één query naar drie landen met elk een stad en print het gebruikte domein en de eerste 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])

Neemt Bing dezelfde parameters?

Ja voor q, gl, hl, device en page: gebruik dezelfde codes met engine=bing. google_domain geldt niet voor Bing en wordt genegeerd. Het antwoord heeft hetzelfde frame, met organic_results en related_searches; zie de Bing-pagina voor de use cases.