Localisations et langues : gl, hl, location, google_domain et device

Quelle est la différence entre gl, hl et location ?

gl indique de quel pays vous voulez les résultats. hl indique dans quelle langue la personne lit, ce qui change l'interface et souvent les questions et les snippets. location restreint le pays à une ville ou une région, ce qui compte dès qu'une requête a une intention locale.

Ils se combinent librement. Un francophone en Suisse, c'est gl=ch, hl=fr. Une requête en anglais depuis Berlin, c'est gl=de, hl=en, location=Berlin, Berlin, Germany. Gardez gl et le pays de location identiques : une ville d'un pays avec un gl d'un autre donne des résultats qu'aucun visiteur réel ne voit.

Comment cibler une ville ?

Écrivez le lieu en anglais, de la plus petite unité à la plus grande : City, Region, Country. Exemples : Austin, Texas, United States, Manchester, England, United Kingdom, Munich, Bavaria, Germany, Lyon, Auvergne-Rhone-Alpes, France. Utilisez le nom de la ville, pas une rue ni un code postal.

Vérifiez search_parameters.location dans la réponse : il indique le lieu qui a été appliqué. Une valeur inutilisable renvoie 400 invalid_parameter et ne coûte rien, vous pouvez donc tester une liste de lieux à moindre coût.

# 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

Quel domaine Google dois-je utiliser ?

Généralement aucun : laissez google_domain de côté et l'API utilise le domaine du pays gl, comme dans le tableau ci-dessus. Ne le définissez que pour reproduire une configuration précise, par exemple google.com avec gl=gb.

Le domaine seul ne définit pas le pays des résultats. gl et location font l'essentiel du travail, c'est pourquoi la réponse enregistre les trois dans search_parameters.

Les résultats mobile et desktop diffèrent-ils ?

Souvent, oui. La page mobile peut ordonner les blocs différemment, afficher plus de résultats locaux pour les intentions de proximité et raccourcir les snippets. Si vos visiteurs utilisent surtout leur téléphone, suivez device=mobile ; pour une vue complète, suivez les deux et stockez l'appareil avec chaque classement.

Chaque appareil est une recherche distincte : suivre les deux double donc les crédits pour ces mots-clés. À 0,56 $US/1K requêtes sur le pack 100 000 recherches, 1 000 mots-clés sur deux appareils pendant 30 jours utilisent 60 000 recherches.

Comment comparer plusieurs pays dans un seul script ?

Bouclez sur une liste de marchés et conservez ce que l'API a appliqué. L'exemple Python envoie une requête vers trois pays avec une ville chacun et affiche le domaine utilisé ainsi que le premier lien.

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

Bing prend-il les mêmes paramètres ?

Oui pour q, gl, hl, device et page : utilisez les mêmes codes avec engine=bing. google_domain ne s'applique pas à Bing et est ignoré. La réponse a la même structure, avec organic_results et related_searches ; consultez la page Bing pour ses cas d'usage.