Emplacements
Pour la plupart des requêtes SERP, une chaîne location= au format libre suffit. Lorsque vous avez besoin d’un ciblage canonique au niveau de la ville, mis en correspondance avec la propre taxonomie de localisation de Google, utilisez l’API Locations pour résoudre des chaînes de lieux en une valeur uule.
Localisation au format libre (simple)
Section intitulée « Localisation au format libre (simple) »Passez la localisation sous forme de chaîne. Shifter la résout vers la géolocalisation la plus proche à la volée.
curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=pizza&location=Chicago%2C+Illinois"Fonctionne pour 95 % des cas d’usage. L’inconvénient : des chaînes ambiguës (Springfield, London) peuvent sélectionner une ville différente de celle attendue.
Géolocalisation canonique avec l’API Locations
Section intitulée « Géolocalisation canonique avec l’API Locations »Pour garantir une ville précise, résolvez-la d’abord :
curl "https://serp.shifter.io/v1?engine=locations&api_key=YOUR_API_KEY&q=Chicago"La réponse liste chaque localisation correspondante avec un nom canonique, country_code, target_type (City, State, Country), et un google_id. Choisissez celle que vous souhaitez et utilisez son nom canonique dans location= :
curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=pizza&location=Chicago%2CIllinois%2CUnited+States"Paire pays et langue
Section intitulée « Paire pays et langue »Combinez gl (pays) et hl (langue) pour obtenir des résultats dans le bon format :
gl | hl | Ce que vous obtenez |
|---|---|---|
us | en | Résultats américains en anglais (par défaut) |
de | de | Résultats allemands en allemand |
jp | ja | Résultats japonais en japonais |
br | pt | Résultats brésiliens en portugais |
curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=news&gl=de&hl=de"Appareil
Section intitulée « Appareil »Les SERP mobiles et de bureau diffèrent sensiblement (fonctionnalités différentes, classements différents). Choisissez explicitement :
curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=laptop&device=mobile"Valeurs : desktop (par défaut), mobile, tablet.
Localisations Yandex
Section intitulée « Localisations Yandex »Yandex utilise ses propres identifiants de localisation via lr :
lr | Ville |
|---|---|
| 1 | Moscou |
| 2 | Saint-Pétersbourg |
| 11316 | Novossibirsk |
| 54 | Iekaterinbourg |
Liste complète disponible via engine=yandex_locations.
- Google, liste des moteurs.
- REST API → SERP Locations, référence complète des paramètres de géolocalisation Google.