Locations und Sprachen: gl, hl, location, google_domain und device

Was ist der Unterschied zwischen gl, hl und location?

gl legt fest, aus welchem Land Sie Ergebnisse wollen. hl legt fest, welche Sprache die Person liest, was die Oberfläche und oft auch die Fragen und Snippets verändert. location grenzt das Land auf eine Stadt oder Region ein, was wichtig wird, sobald eine Suchanfrage eine lokale Absicht hat.

Sie lassen sich frei kombinieren. Ein französischsprachiger Nutzer in der Schweiz ist gl=ch, hl=fr. Eine englischsprachige Suche aus Berlin ist gl=de, hl=en, location=Berlin, Berlin, Germany. Halten Sie gl und das Land von location gleich: eine Stadt in einem Land mit gl eines anderen liefert Ergebnisse, die kein echter Besucher sieht.

Wie richte ich mich auf eine Stadt aus?

Schreiben Sie den Ort auf Englisch, von der kleinsten Einheit zur größten: City, Region, Country. Beispiele: Austin, Texas, United States, Manchester, England, United Kingdom, Munich, Bavaria, Germany, Lyon, Auvergne-Rhone-Alpes, France. Verwenden Sie den Namen der Stadt, keine Straße und keine Postleitzahl.

Prüfen Sie search_parameters.location in der Antwort: Es zeigt den angewandten Ort. Ein Wert, der nicht verwendet werden kann, gibt 400 invalid_parameter zurück und kostet nichts, sodass Sie eine Liste von Orten günstig testen können.

# 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

Welche Google-Domain sollte ich verwenden?

Normalerweise keine: Lassen Sie google_domain weg, und die API verwendet die Domain des Landes aus gl, wie in der Tabelle oben. Setzen Sie sie nur, um eine bestimmte Konfiguration nachzubilden, zum Beispiel google.com mit gl=gb.

Die Domain allein legt das Land der Ergebnisse nicht fest. gl und location leisten den Großteil der Arbeit, deshalb zeichnet die Antwort alle drei in search_parameters auf.

Unterscheiden sich die Ergebnisse auf Mobilgeräten und Desktop?

Häufig ja. Die mobile Seite kann Blöcke anders anordnen, mehr lokale Ergebnisse für nahegelegene Suchintentionen anzeigen und Snippets kürzer fassen. Wenn Ihre Besucher überwiegend Smartphones nutzen, erfassen Sie device=mobile; für ein vollständiges Bild erfassen Sie beides und speichern das Gerät mit jedem Ranking.

Jedes Gerät ist eine separate Suche, daher verdoppelt die Erfassung beider Geräte die Credits für diese Keywords. Bei 0,56 $/1K Suchanfragen im 100.000 Suchanfragen-Pack verbrauchen 1.000 Keywords auf zwei Geräten über 30 Tage 60.000 Suchen.

Wie vergleiche ich mehrere Länder in einem Skript?

Iterieren Sie über eine Liste von Märkten und behalten Sie, was die API angewendet hat. Das Python-Beispiel sendet eine Suchanfrage an drei Länder mit jeweils einer Stadt und gibt die verwendete Domain und den ersten Link aus.

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

Nimmt Bing dieselben Parameter?

Ja für q, gl, hl, device und page: Verwenden Sie dieselben Codes mit engine=bing. google_domain gilt nicht für Bing und wird ignoriert. Die Antwort hat denselben Aufbau, mit organic_results und related_searches; siehe die Bing-Seite für ihre Anwendungsfälle.