Standorte

Bei den meisten SERP-Anfragen reicht eine freie location=-Zeichenkette aus. Wenn Sie eine kanonische, stadtgenaue Ausrichtung benötigen, die mit Googles eigener Standort-Taxonomie abgeglichen wird, verwenden Sie die Locations API, um Ortsangaben in einen uule-Wert aufzulösen.

Freie Standortangabe (einfach)

Übergeben Sie den Standort als Zeichenkette. Shifter löst sie dynamisch in die am besten passende geografische Region auf.

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=pizza&location=Chicago%2C+Illinois"

Funktioniert für 95 % der Anwendungsfälle. Der Nachteil: Mehrdeutige Zeichenketten (Springfield, London) können eine andere Stadt auswählen als erwartet.

Kanonische Geodaten mit der Locations API

Um eine bestimmte Stadt zu garantieren, lösen Sie diese zuerst auf:

curl "https://serp.shifter.io/v1?engine=locations&api_key=YOUR_API_KEY&q=Chicago"

Die Antwort listet jeden übereinstimmenden Standort mit einem kanonischen Namen, country_code, target_type (City, State, Country) und einer google_id auf. Wählen Sie den gewünschten aus und verwenden Sie dessen kanonischen Namen in location=:

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=pizza&location=Chicago%2CIllinois%2CUnited+States"

Land- und Sprachpaar

Kombinieren Sie gl (Land) und hl (Sprache), um Ergebnisse im richtigen Format zu erhalten:

gl	hl	Was Sie erhalten
us	en	US-Ergebnisse auf Englisch (Standard)
de	de	Deutsche Ergebnisse auf Deutsch
jp	ja	Japanische Ergebnisse auf Japanisch
br	pt	Brasilianische Ergebnisse auf Portugiesisch

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=news&gl=de&hl=de"

Gerät

Mobile und Desktop-SERPs unterscheiden sich erheblich (unterschiedliche Funktionen, unterschiedliche Rankings). Wählen Sie explizit aus:

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=laptop&device=mobile"

Werte: desktop (Standard), mobile, tablet.

Tipp

Für Rank-Tracking sollten Sie gl, hl, device und location immer explizit festlegen. Wenn Sie sie auf den Standardwerten belassen, führt das über mehrere Durchläufe hinweg zu inkonsistenten Ergebnissen.

Yandex-Standorte

Yandex verwendet über lr eigene Standort-IDs:

lr	Stadt
1	Moskau
2	Sankt Petersburg
11316	Nowosibirsk
54	Jekaterinburg

Die vollständige Liste ist über engine=yandex_locations verfügbar.

Nächste Schritte

• Google, Liste der Engines.
• REST API → SERP-Standorte, vollständige Referenz der Google-Geoparameter.